@lazyingart/agintiflow 0.20.182 → 0.20.183

package/README.md

@@ -153,7 +153,7 @@ aginti --language de
 | Save provider keys | `aginti auth`, `/auth`, `/login` |
 | Review current repo | `/review [focus]` |
 | Toggle SCS quality gate | `/scs` |
-| Use SCS only for complex work | `/scs auto` or `aginti --scs auto "task"` |
+| Keep default auto SCS routing | `/scs auto` or `aginti --scs auto "task"` |
 | Disable SCS for simple work | `/scs off` or `aginti --no-scs "task"` |
 | Control dynamic step budgets | `--dynamic-steps auto\|on\|off` |
 | Work with AAPS workflows | `aginti aaps status`, `/aaps validate` |

package/docs/student-committee-supervisor.md

@@ -61,13 +61,13 @@ The current implementation is deliberately bounded:
 
 ## Auto Mode
 
-`/scs auto` and `--scs auto` are still available when a user wants cheaper routing for simple turns. Auto mode activates SCS for complex, risky, or long-running work. Signals include:
+`/scs auto` and `--scs auto` are the default for users who want cheap simple turns without losing strict validation on risky work. Auto mode activates SCS for high-risk, evidence-heavy, or long-running work. Signals include:
 
-- high smart-routing complexity score;
-- profiles such as code, app, Android/iOS, large-codebase, GitHub, maintenance, security, LaTeX, research, and supervision;
-- prompts mentioning multi-file work, regressions, builds, deployments, tmux, emulators, Docker, PDFs, or similar high-friction workflows.
+- very high smart-routing complexity score;
+- profiles such as app, Android/iOS, large-codebase, GitHub, maintenance, QA, security, supervision, pipeline, and website;
+- prompts mentioning failing tests, repo-wide changes, browser uploads, releases, deployments, tmux, emulators, Docker, PDFs, or similar high-friction workflows.
 
-Auto mode stays off for simple turns, but it is not the default.
+Auto mode is the default. It stays off for simple turns, uses the main model for moderate complexity, and activates SCS only for high-risk or evidence-heavy turns.
 
 ## Dynamic Step Budgets
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.20.182",
+  "version": "0.20.183",
   "type": "module",
   "description": "AgInTiFlow is a project-aware agent workspace for hybrid wet-dry R&D, hardware-aware intelligence, software automation, and industrial workflows.",
   "license": "Apache-2.0",

package/public/app.js

@@ -1402,7 +1402,7 @@ function syncQuickModeControls() {
   if (aapsModeToggle) aapsModeToggle.checked = (taskProfileField?.value || "auto") === "aaps";
   if (veniceModeToggle) veniceModeToggle.checked = quickVeniceModeActive;
   if (quickModeStatusEl) {
-    const scs = enableScsField?.value || "on";
+    const scs = enableScsField?.value || "auto";
     const profile = taskProfileField?.value || "auto";
     const route = `${routeProviderField?.value || "deepseek"}/${fieldValue(routeModelField) || "auto"}`;
     const main = `${mainProviderField?.value || "deepseek"}/${fieldValue(mainModelField) || "auto"}`;
@@ -1451,8 +1451,8 @@ function applyVeniceMode(enabled) {
   syncQuickModeControls();
 }
 
-function applyScsMode(mode = enableScsField?.value || "on") {
-  if (enableScsField) enableScsField.value = ["on", "auto", "off"].includes(mode) ? mode : "on";
+function applyScsMode(mode = enableScsField?.value || "auto") {
+  if (enableScsField) enableScsField.value = ["on", "auto", "off"].includes(mode) ? mode : "auto";
   if (allowParallelScoutsField && enableScsField?.value === "on") {
     allowParallelScoutsField.checked = false;
   }
@@ -1707,7 +1707,7 @@ function formPayload() {
     allowWebSearch: allowWebSearchField?.checked ?? true,
     allowMcpTools: allowMcpToolsField?.checked ?? true,
     allowParallelScouts: allowParallelScoutsField?.checked ?? true,
-    enableScs: enableScsField?.value || "on",
+    enableScs: enableScsField?.value || "auto",
     dynamicSteps: dynamicStepsField?.value || "auto",
     veniceMode: quickVeniceModeActive,
     parallelScoutCount: Math.min(Math.max(Number(parallelScoutCountField?.value) || 3, 1), 10),
@@ -3818,7 +3818,7 @@ async function loadConfig() {
   if (allowWebSearchField) allowWebSearchField.checked = prefs.allowWebSearch ?? true;
   if (allowMcpToolsField) allowMcpToolsField.checked = prefs.allowMcpTools ?? true;
   if (allowParallelScoutsField) allowParallelScoutsField.checked = prefs.allowParallelScouts ?? true;
-  if (enableScsField) enableScsField.value = prefs.enableScs || "on";
+  if (enableScsField) enableScsField.value = prefs.enableScs || "auto";
   if (dynamicStepsField) dynamicStepsField.value = prefs.dynamicSteps || "auto";
   if (parallelScoutCountField) parallelScoutCountField.value = String(prefs.parallelScoutCount || 3);
   allowWrapperToolsField.checked = prefs.allowWrapperTools ?? false;

package/public/index.html

@@ -264,8 +264,8 @@
             <label class="quick-mode-select">
               <span data-i18n="scsModeLabel">SCS</span>
               <select id="enableScs" name="enableScs">
-                <option value="on" data-i18n="scsOnOption">On</option>
                 <option value="auto" data-i18n="scsAutoOption">Auto</option>
+                <option value="on" data-i18n="scsOnOption">On</option>
                 <option value="off" data-i18n="scsOffOption">Off</option>
               </select>
             </label>

package/references/aginti-generalization-audit-2026-05-20.md

@@ -60,7 +60,8 @@ npm run smoke:model-roles
 node scripts/smoke-skills.js
 node scripts/smoke-dynamic-step-budget.js
 node scripts/smoke-coding-tools.js
-rg -n --hidden --glob '!node_modules/**' --glob '!.git/**' --glob '!dist/**' --glob '!coverage/**' 'xiaoyunque|小云雀|xyq|jianying|LALACHAN|啦啦|拉拉|阿芽|飒飒|Seedance|沉浸式短片|Trio\.png|display\.png|R1\.jpg|patchwork-leather|duanpian' .
+rg -n --hidden --glob '!node_modules/**' --glob '!.git/**' --glob '!dist/**' --glob '!coverage/**' '<private-project-term-pattern>' .
 ```
 
-Result: checks passed, and the repository search found no remaining private workflow terms in AgInTiFlow runtime code, tests, or general references after excluding this audit's own search expression.
+Result: checks passed, and the repository search found no remaining private
+workflow terms in AgInTiFlow runtime code, tests, or general references.

package/references/agintiflow-npm-publication-memory.md

@@ -6,6 +6,18 @@ This note records the working publication route for AgInTiFlow so future release
 
 ## Published Evidence
 
+Latest verified release:
+
+- Version: `0.20.182`
+- Commit: `b5492f7`
+- GitHub Actions run: `https://github.com/lazyingart/AgInTiFlow/actions/runs/26198123298`
+- Workflow result: success
+- npm registry check: `npm view @lazyingart/agintiflow version` returned `0.20.182`
+- Installed verification: `npm install -g @lazyingart/agintiflow@0.20.182` then `aginti --version` returned `0.20.182`
+- Webapp verification: `aginti webapp restart --port 3210` then `curl -fsS http://127.0.0.1:3210/health` returned `version":"0.20.182"` from the global npm package path.
+
+Previous reference release:
+
 - Package: `@lazyingart/agintiflow`
 - Version: `0.20.169`
 - Commit: `6ef3768`

package/references/bilingual-book-supervision-lessons.md

@@ -1,7 +1,7 @@
 # Bilingual Book Supervision Lessons
 
-This note records lessons from supervising AgInTiFlow on the ZhJpBook bilingual
-interlinear book pipeline. The goal is not to make AgInTiFlow a book-specific
+This note records lessons from supervising AgInTiFlow on a multilingual
+annotated book pipeline. The goal is not to make AgInTiFlow a book-specific
 tool. The goal is to identify which failures were project workflow issues and
 which reusable capabilities AgInTiFlow needs in order to complete large artifact
 projects from raw inputs to final outputs with less external guidance.
@@ -19,25 +19,25 @@ Observed AgInTiFlow primitives:
 - `docs/self-healing-pipelines.md`
 - `docs/auxiliary-image-generation.md`
 
-Observed ZhJpBook workflow pieces:
+Observed project-local workflow pieces:
 
-- `scripts/interlinear/aginti_write_chunks.py`
-- `scripts/interlinear/aginti_dynamic_review_chunks.py`
-- `scripts/interlinear/start_aginti_parallel_json_writers.sh`
-- `scripts/interlinear/watch_aginti_compile.py`
-- `scripts/interlinear/compile_prepared_book_both_previews.sh`
+- source ingestion and cleanup scripts
+- chunk writer runners
+- dynamic review scripts
+- parallel structured-output workers
+- compile and progress-watch scripts
 
-Observed Sishu run evidence:
+Observed large-run evidence:
 
-- The book reached `2480/2480` manifest chunks valid with no missing chunks.
-- The final compile produced four PDFs: ZH-main and JP-main, color and
-  blackwhite.
-- Page counts were `2387` for ZH-main and `2065` for JP-main.
+- The book reached full manifest coverage with no missing chunks.
+- The final compile produced multiple language, direction, and style variants.
+- Page counts differed by output variant and had to be verified against the
+  current manifest.
 - A stale compile-watch status still reported older failed counts after the
   canonical progress report was clean, showing that multiple status snapshots
   can diverge unless one source of truth is enforced.
 - AgInTi image generation was useful for cover backgrounds, but exact title,
-  author, furigana, and curation text still needed deterministic composition.
+  author, annotations, and curation text still needed deterministic composition.
 
 ## Main Finding
 
@@ -66,11 +66,12 @@ artifact-pipeline lifecycle that AgInTi can instantiate and supervise:
 These belong in the target repository or generated project scripts, not in
 AgInTiFlow core:
 
-- Book-specific source schemas and bilingual chunk schemas.
-- Chinese/Japanese rendering decisions, TeX macros, page size, grammar colors,
-  ruby placement, table of contents, and cover typography.
-- Exact validators for source preservation, Hanzi tokenization, furigana/pinyin
-  policy, grammar roles, and line-based interlinear layout.
+- Book-specific source schemas and annotated chunk schemas.
+- Language-pair rendering decisions, TeX or renderer macros, page size,
+  grammar colors, reading placement, table of contents, and cover typography.
+- Exact validators for source preservation, script-specific tokenization,
+  reading or romanization policy, grammar roles, and line-based interlinear
+  layout.
 - Book plans, source bundles, source-specific OCR cleanup rules, and known
   editions/translations.
 - The concrete writer prompt for one literary/classical task.
@@ -132,8 +133,8 @@ Recommended core behavior:
 ### 2. Restarting From Zero Destroyed Efficiency
 
 Large book work is valuable even when partial. The most expensive artifacts were
-translation/alignment/ruby/grammar chunks. Retuning chunk size or prompt
-instructions should not discard reviewed chunks.
+translation, alignment, reading, and grammar chunks. Retuning chunk size or
+prompt instructions should not discard reviewed chunks.
 
 Recommended core behavior:
 
@@ -164,7 +165,7 @@ Recommended core behavior:
 
 The deterministic reviewer fixed schema/render issues. The user also wanted
 review that notices OCR corruption, missing text, bad line alignment, all-one
-color grammar pages, kana-only Japanese, source drift, and repeated filler.
+color grammar pages, wrong-script output, source drift, and repeated filler.
 
 Recommended core behavior:
 
@@ -177,8 +178,8 @@ Recommended core behavior:
 
 ### 5. OCR and Source Ingestion Were Underestimated
 
-For scanned Chinese books, bad OCR flowed into later high-cost annotation. The
-right place to catch this is before bilingual generation.
+For scanned or OCR-heavy books, bad OCR flowed into later high-cost annotation.
+The right place to catch this is before multilingual generation.
 
 Recommended core behavior:
 
@@ -201,7 +202,7 @@ Recommended core behavior:
 
 - Cover/poster workflows should default to "image model creates background;
   deterministic renderer adds exact text" when exact titles, author names, URLs,
-  ruby, or branding are required.
+  reading marks, annotations, or branding are required.
 - The image-generation tool should save raw prompt/result metadata, but project
   scripts should own final typography.
 

package/references/codex-session-cross-references.md

@@ -65,11 +65,11 @@ Project-local skill produced from this direction:
 
 - `.aginti/skills/<project-browser-workflow>/SKILL.md` in the task repository
 
-### ZhJpBook And AgInTiFlow Implementation Session
+### Multilingual Book Pipeline And AgInTiFlow Implementation Session
 
 - Session: `019e1f99-289e-7711-986a-d41047f5ed21`
-- Status context shown by Codex: `~/ProjectsLFS/ZhJpBook`
-- Primary task repo involved: `/home/lachlan/ProjectsLFS/ZhJpBook`
+- Status context shown by Codex: a project-local multilingual book repository
+- Primary task repo involved: project-local, outside AgInTiFlow core
 - AgInTiFlow implementation repo: `/home/lachlan/ProjectsLFS/Agent/AgInTiFlow`
 - Role: implementation and validation session.
 
@@ -129,9 +129,9 @@ These sessions should be read together:
   owner.
 - The browser workflow session supplies the concrete failure mode: browser automation and media tasks
   can look successful while the visible external state is wrong or unverified.
-- ZhJpBook supplies the long-running pipeline pressure: the agent must keep
-  moving through scripts, monitors, validators, and artifacts without accepting
-  unsupported finish claims.
+- The multilingual book pipeline supplies the long-running pipeline pressure:
+  the agent must keep moving through scripts, monitors, validators, and
+  artifacts without accepting unsupported finish claims.
 - AAPS supplies the project/workflow/block/program front-end contract where
   AgInTiFlow may act as a backend adapter but must not mutate AAPS scope or
   semantics unexpectedly.

package/references/dynamic-step-budget-and-scs-auto.md

@@ -1,6 +1,6 @@
 # Dynamic Step Budget And SCS Auto Routing
 
-This note documents the implemented design for dynamic `maxSteps` extension and SCS routing. SCS now defaults to `on`; auto routing remains available with `--scs auto` or `/scs auto` when a user wants SCS only for complex turns.
+This note documents the implemented design for dynamic `maxSteps` extension and SCS routing. SCS defaults to `auto`: simple turns use the fast route, moderate work can use the main model without heavy validation, and high-risk evidence-bearing work activates the Student-Committee-Supervisor gates.
 
 ## Current State
 
@@ -15,11 +15,11 @@ Relevant paths:
 - `src/step-budget-controller.js`: owns deterministic progress/blocker checks, caps, serialization, and extension application.
 - `src/scs-controller.js`: supports `off`, `on`, `auto`, and the SCS student step-budget gate.
 
-SCS auto is supported but is not the default:
+SCS auto is the default:
 
 - CLI: `--scs auto`.
 - Interactive: `/scs auto`.
-- Config: `enableScs: "on"` by default, or `"auto"` when explicitly requested.
+- Config: `enableScs: "auto"` by default, or `"on"`/`"off"` when explicitly requested.
 - Router policy: `shouldActivateScs("auto", { goal, taskProfile, complexityScore })`.
 - Active model policy: when SCS is active, committee/student/supervisor use the main model.
 
@@ -86,11 +86,11 @@ SCS mode allows a slightly larger budget because the student gate is stricter:
 
 ### SCS Auto Mode
 
-`/scs auto` means the router may activate SCS for a specific turn. Signals include:
+`/scs auto` means the router may activate SCS for a specific turn. It deliberately has a higher bar than smart model routing, so a turn can use the main model without paying SCS overhead. Signals include:
 
-- high smart-routing complexity score;
-- high-friction profiles such as Android, app, code, large-codebase, GitHub, maintenance, QA, research, review, security, supervision, or website;
-- prompt language such as debug, failing, migration, emulator, deploy, PDF, refactor, monitor, or long-running.
+- very high smart-routing complexity score;
+- high-friction profiles such as Android, app, large-codebase, GitHub, maintenance, QA, security, supervision, pipeline, or website;
+- prompt language such as failing tests, fix the build, migration, deploy, browser automation, upload, PDF compilation, publish, monitor, or long-running.
 
 If SCS auto activates, dynamic step extension uses the SCS student gate. If SCS auto does not activate, dynamic step extension uses the normal deterministic gate.
 
@@ -212,7 +212,7 @@ Defaults:
 Routing semantics:
 
 - `/scs off`: never use SCS; dynamic budget uses normal deterministic monitoring if enabled.
-- `/scs on`: always use SCS; this is the default, and dynamic budget uses the student budget gate.
+- `/scs on`: always use SCS, and dynamic budget uses the student budget gate.
 - `/scs auto`: router decides per run; if activated, dynamic budget uses the student gate.
 
 For observability, state preserves:

package/references/student-committee-supervisor-mode.md

@@ -187,7 +187,7 @@ Recommended modes:
 | --- | --- |
 | `off` | Current behavior. |
 | `on` | SCS gates all non-trivial work in the session. |
-| `auto` | SCS only activates for complex tasks, write actions, multi-step shell work, GitHub, system maintenance, Android/iOS, LaTeX/PDF, and long-running tasks. |
+| `auto` | Default. Simple turns stay linear, moderate tasks may use the main model without SCS, and SCS activates for high-risk/evidence-heavy work such as failing builds, repo-wide edits, GitHub/release work, browser uploads, system maintenance, Android/iOS, LaTeX/PDF compilation, and long-running supervision. |
 
 `/scs` should toggle SCS on/off in interactive CLI. `/scs auto` keeps the mature complex-task gate for users who want quality control without paying the SCS cost on simple turns.
 

package/scripts/smoke-cli-chat.js

@@ -795,12 +795,12 @@ try {
     throw new Error("interactive /review did not launch the bounded review workflow");
   }
   const scsDefaultStatusResult = await runChat("/scs status\n");
-  if (!scsDefaultStatusResult.stdout.includes("SCS mode: on")) {
-    throw new Error("interactive /scs status did not show default on mode");
+  if (!scsDefaultStatusResult.stdout.includes("SCS mode: auto")) {
+    throw new Error("interactive /scs status did not show default auto mode");
   }
   const statusFooterResult = await runChat("/status\n");
   if (
-    !statusFooterResult.stdout.includes(`cwd=${tempRoot} scs=on aaps=off venice=off`) ||
+    !statusFooterResult.stdout.includes(`cwd=${tempRoot} scs=auto aaps=off venice=off`) ||
     !statusFooterResult.stdout.includes("permission=")
   ) {
     throw new Error("interactive /status did not include scs/aaps/venice mode state on the cwd line");

package/scripts/smoke-dynamic-step-budget.js

@@ -218,7 +218,8 @@ try {
       sessionId: "dynamic-step-budget-smoke",
     }
   );
-  assert(config.enableScs === "on", "runtime config should default SCS mode to on");
+  assert(config.enableScs === "auto", "runtime config should default SCS mode to auto");
+  assert(config.scsActive === false, "simple mock write should not activate SCS in auto mode");
   const run = await runAgent(config);
   assert(!run.stopped, "mock run stopped instead of using dynamic extension");
   const written = await fs.readFile(path.join(workspace, "notes/dynamic-budget.md"), "utf8");

package/scripts/smoke-model-roles.js

@@ -16,9 +16,11 @@ import {
   buildSupervisorInstruction,
   deterministicPlanActionContradiction,
   reviewScsFinish,
+  shouldActivateScs,
   shouldRequestScsReplan,
 } from "../src/scs-controller.js";
 import { buildScsEvidenceLedger, deriveScsTaskContract, evaluateScsEvidence } from "../src/scs-evidence.js";
+import { resolveRuntimeConfig } from "../src/config.js";
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 
@@ -116,6 +118,86 @@ const fastRoute = selectModelRoute({
 });
 assert(fastRoute.model === "deepseek-v4-flash", "fast route did not use route model override");
 
+const simpleSmartRoute = selectModelRoute({
+  routingMode: "smart",
+  provider: "deepseek",
+  goal: "say hello",
+  taskProfile: "auto",
+});
+assert(simpleSmartRoute.model === "deepseek-v4-flash", "simple smart route should use the route model");
+assert(
+  !shouldActivateScs("auto", {
+    goal: "say hello",
+    taskProfile: "auto",
+    complexityScore: simpleSmartRoute.complexityScore,
+  }),
+  "SCS auto should stay inactive for simple turns"
+);
+
+const moderateSmartRoute = selectModelRoute({
+  routingMode: "smart",
+  provider: "deepseek",
+  goal: "implement a focused refactor design for one module",
+  taskProfile: "auto",
+});
+assert(moderateSmartRoute.model === "deepseek-v4-pro", "moderate smart route should use the main model");
+assert(
+  !shouldActivateScs("auto", {
+    goal: "implement a focused refactor design for one module",
+    taskProfile: "auto",
+    complexityScore: moderateSmartRoute.complexityScore,
+  }),
+  "SCS auto should not gate every main-model turn"
+);
+
+const highRiskSmartRoute = selectModelRoute({
+  routingMode: "smart",
+  provider: "deepseek",
+  goal: "debug failing tests and fix the build in a large repo, then commit and push",
+  taskProfile: "auto",
+});
+assert(highRiskSmartRoute.model === "deepseek-v4-pro", "high-risk smart route should use the main model");
+assert(
+  shouldActivateScs("auto", {
+    goal: "debug failing tests and fix the build in a large repo, then commit and push",
+    taskProfile: "auto",
+    complexityScore: highRiskSmartRoute.complexityScore,
+  }),
+  "SCS auto should activate for high-risk evidence-bearing work"
+);
+assert(
+  !shouldActivateScs("auto", { goal: "explain this function", taskProfile: "code", complexityScore: 0 }),
+  "code profile alone should not force SCS auto"
+);
+
+const simpleRuntimeConfig = resolveRuntimeConfig({
+  goal: "say hello",
+  provider: "deepseek",
+  routingMode: "smart",
+  taskProfile: "auto",
+});
+assert(simpleRuntimeConfig.enableScs === "auto", "runtime config should default SCS mode to auto");
+assert(simpleRuntimeConfig.scsActive === false, "simple runtime config should not activate SCS");
+assert(simpleRuntimeConfig.model === "deepseek-v4-flash", "simple runtime config should use route model");
+
+const moderateRuntimeConfig = resolveRuntimeConfig({
+  goal: "implement a focused refactor design for one module",
+  provider: "deepseek",
+  routingMode: "smart",
+  taskProfile: "auto",
+});
+assert(moderateRuntimeConfig.scsActive === false, "moderate main-model work should not automatically activate SCS");
+assert(moderateRuntimeConfig.model === "deepseek-v4-pro", "moderate runtime config should use main model");
+
+const highRiskRuntimeConfig = resolveRuntimeConfig({
+  goal: "debug failing tests and fix the build in a large repo, then commit and push",
+  provider: "deepseek",
+  routingMode: "smart",
+  taskProfile: "auto",
+});
+assert(highRiskRuntimeConfig.scsActive === true, "high-risk runtime config should activate SCS");
+assert(highRiskRuntimeConfig.model === "deepseek-v4-pro", "SCS runtime config should use main model");
+
 assert(MODEL_PROVIDER_GROUPS["venice-gpt"].provider === "venice", "venice-gpt group missing");
 assert(modelsForProviderGroup("venice").some((item) => item.id === "venice-uncensored-1-2"), "venice group missing Venice 1.2");
 assert(modelsForProviderGroup("venice-gemma").some((item) => item.id === "google-gemma-4-31b-it"), "venice-gemma bucket missing Gemma 4 instruct");

package/scripts/smoke-web-api.js

@@ -117,7 +117,7 @@ try {
   if (config.preferences?.packageInstallPolicy !== "allow") throw new Error("web did not default to Docker package installs");
   if (config.preferences?.permissionMode !== "normal") throw new Error("web did not default to normal permission mode");
   if (config.preferences?.workspaceWritePolicy !== "allow") throw new Error("web did not default to workspace writes allowed");
-  if (config.preferences?.enableScs !== "on") throw new Error("web did not default to CLI-aligned SCS on mode");
+  if (config.preferences?.enableScs !== "auto") throw new Error("web did not default to CLI-aligned SCS auto mode");
   if (config.preferences?.dynamicSteps !== "auto") throw new Error("web did not default to CLI-aligned dynamic steps auto mode");
   if (config.preferences?.veniceMode !== false) throw new Error("web should default Venice shortcut mode off");
   if (Number(config.preferences?.maxSteps) < 24) throw new Error("web default max steps is too low");

package/skills/bilingual-interlinear-book/SKILL.md

@@ -9,11 +9,11 @@ triggers:
   - paired language
   - annotated book
   - parallel text
-  - ruby
-  - furigana
-  - pinyin
-  - xelatex
-  - pocket book
+  - aligned annotations
+  - glossed text
+  - reading annotations
+  - translation notes
+  - source commentary
 tools:
   - read_file
   - write_file
@@ -46,7 +46,7 @@ This is a general workflow skill. It must not hard-code a specific book, languag
 Keep annotation policies project-defined:
 
 - Token shape, reading placement, grammar tags, and alignment granularity must come from the project schema.
-- For scripts that need per-character readings, validators should enforce that locally instead of relying on a prompt.
+- For scripts that need per-token or per-character readings, validators should enforce that locally instead of relying on a prompt.
 - Placeholder translations, empty commentary, duplicated readings, copied modern paraphrases, or source drift should be detected by validators or reviewers.
 - Translation/reference quality gates must be derived from the project schema, language profile, and source audit. Do not bake one book's vocabulary, source names, or forbidden-token list into this built-in skill or AgInTiFlow core.
 - If a reference is unreliable for the requested target language, do not feed it to the writer as trusted translation. Either omit it, label it clearly as alignment/source-only context, or ask the project to supply a reliable reference.

package/src/agent-runner.js

@@ -43,6 +43,7 @@ import { isMcpBridgeTool } from "./mcp/policy.js";
 import { executeMcpBridgeTool } from "./mcp/tool-bridge.js";
 import { longJobStatus, startLongJob } from "./long-job-tools.js";
 import {
+  DEFAULT_SCS_MODE,
   buildSupervisorInstruction,
   createScsPlan,
   createScsReplan,
@@ -866,7 +867,7 @@ async function maybeExtendStepBudget({ client, config, state, store, observers,
       runtimeDecision,
       stepBudget: serializeStepBudgetState(stepBudget),
     });
-    state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || "on", active: true };
+    state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || DEFAULT_SCS_MODE, active: true };
     state.meta.scs.budgetReviews = (state.meta.scs.budgetReviews || 0) + 1;
     state.meta.scs.lastStudentDecision = scsDecision;
     await store.appendEvent(`scs.student.${scsDecision.decision}`, {
@@ -969,7 +970,7 @@ async function requestScsReplan({ client, config, state, store, observers, decis
   if (!config.scsActive || !shouldRequestScsReplan(decision)) return null;
   state.meta.scs = state.meta.scs || {
     enabled: true,
-    mode: config.enableScs || "on",
+    mode: config.enableScs || DEFAULT_SCS_MODE,
     active: true,
     model: `${config.provider}/${config.model}`,
     phase: 1,
@@ -2368,12 +2369,12 @@ export async function runAgent(config) {
         await store.appendEvent("scs.plan.requested", {
           provider: config.provider,
           model: config.model,
-          mode: config.enableScs || "on",
+          mode: config.enableScs || DEFAULT_SCS_MODE,
         });
         observers.event("scs.plan.requested", {
           provider: config.provider,
           model: config.model,
-          mode: config.enableScs || "on",
+          mode: config.enableScs || DEFAULT_SCS_MODE,
         });
         const scsPlan = await createScsPlan(client, config, state, {
           events: await store.loadEvents(),
@@ -2444,7 +2445,7 @@ export async function runAgent(config) {
     } else if (config.scsActive && !state.meta?.scs?.supervisorInstructionInjected) {
       state.meta.scs = state.meta.scs || {
         enabled: true,
-        mode: config.enableScs || "on",
+        mode: config.enableScs || DEFAULT_SCS_MODE,
         active: true,
         model: `${config.provider}/${config.model}`,
         phase: 1,
@@ -2547,7 +2548,7 @@ export async function runAgent(config) {
     emitConsole(config, `Provider: ${config.provider}`, { kind: "meta" });
     emitConsole(config, `Model: ${config.model}`, { kind: "meta" });
     emitConsole(config, `Routing: ${config.routingMode} (${config.routeReason})`, { kind: "meta" });
-    if (config.scsActive) emitConsole(config, `SCS: ${config.enableScs || "on"} using main-model policy`, { kind: "meta" });
+    if (config.scsActive) emitConsole(config, `SCS: ${config.enableScs || DEFAULT_SCS_MODE} using main-model policy`, { kind: "meta" });
     emitConsole(config, `Workspace: ${config.commandCwd}`, { kind: "meta" });
     emitConsole(config, `Sessions: ${config.sessionsDir}`, { kind: "meta" });
     if (config.projectSessionsDir) emitConsole(config, `Project session index: ${config.projectSessionsDir}`, { kind: "meta" });
@@ -2731,7 +2732,7 @@ export async function runAgent(config) {
             taskProfile: config.taskProfile,
             goal: config.goal,
           });
-          state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || "on", active: true };
+          state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || DEFAULT_SCS_MODE, active: true };
           state.meta.scs.lastStudentDecision = decision;
           await store.appendEvent(`scs.student.${decision.decision}`, decision);
           observers.event(`scs.student.${decision.decision}`, {
@@ -2860,7 +2861,7 @@ export async function runAgent(config) {
               taskProfile: config.taskProfile,
               goal: config.goal,
             });
-            state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || "on", active: true };
+            state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || DEFAULT_SCS_MODE, active: true };
             state.meta.scs.lastStudentDecision = decision;
             await store.appendEvent(`scs.student.${decision.decision}`, decision);
             observers.event(`scs.student.${decision.decision}`, {
@@ -2940,7 +2941,7 @@ export async function runAgent(config) {
             taskProfile: config.taskProfile,
             goal: config.goal,
           });
-          state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || "on", active: true };
+          state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || DEFAULT_SCS_MODE, active: true };
           state.meta.scs.monitorReviews = (state.meta.scs.monitorReviews || 0) + 1;
           state.meta.scs.lastStudentDecision = decision;
           await store.appendEvent(`scs.student.${decision.decision}`, {
@@ -2992,7 +2993,7 @@ export async function runAgent(config) {
           taskProfile: config.taskProfile,
           goal: config.goal,
         });
-        state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || "on", active: true };
+        state.meta.scs = state.meta.scs || { enabled: true, mode: config.enableScs || DEFAULT_SCS_MODE, active: true };
         state.meta.scs.monitorReviews = (state.meta.scs.monitorReviews || 0) + 1;
         state.meta.scs.lastStudentDecision = decision;
         await store.appendEvent(`scs.student.${decision.decision}`, {

package/src/cli.js

@@ -37,6 +37,7 @@ import { handleSkillMeshCommand } from "./skillmesh.js";
 import { handleAapsCliCommand } from "./aaps-adapter.js";
 import { formatInstructionTemplateList, normalizeInstructionTemplate } from "./behavior-contract.js";
 import { applyPermissionMode, normalizePermissionMode } from "./permission-modes.js";
+import { DEFAULT_SCS_MODE } from "./scs-controller.js";
 import { ensureAgintiWebApp, readWebAppPreference, stopAgintiWebApp, writeWebAppPreference } from "./web-autostart.js";
 import { dockerHostInstallPlan, formatDockerSetupText, summarizeDockerSetup } from "./docker-setup.js";
 import { mcpCliCommand, formatMcpCliResult } from "./mcp/tool-bridge.js";
@@ -984,7 +985,7 @@ function agentDefaults(args) {
     allowWebSearch: args.allowWebSearch ?? true,
     allowMcpTools: args.allowMcpTools ?? true,
     allowParallelScouts: args.allowParallelScouts ?? true,
-    enableScs: args.enableScs || process.env.AGINTI_SCS_MODE || "on",
+    enableScs: args.enableScs || process.env.AGINTI_SCS_MODE || DEFAULT_SCS_MODE,
     parallelScoutCount: args.parallelScoutCount || (Number.isFinite(envScoutCount) && envScoutCount > 0 ? envScoutCount : 3),
     sandboxMode: args.sandboxMode || envSandboxMode || permissionDefaults.sandboxMode || "docker-workspace",
     packageInstallPolicy: args.packageInstallPolicy || envPackageInstallPolicy || permissionDefaults.packageInstallPolicy || "allow",

package/src/config.js

@@ -7,7 +7,7 @@ import { loadProjectEnv, projectPaths, resolveProjectRoot } from "./project.js";
 import { normalizeTaskProfile } from "./task-profiles.js";
 import { recommendedMaxStepsForTask } from "./engineering-guidance.js";
 import { resolveLanguage } from "./i18n.js";
-import { normalizeScsMode, shouldActivateScs } from "./scs-controller.js";
+import { DEFAULT_SCS_MODE, normalizeScsMode, shouldActivateScs } from "./scs-controller.js";
 import { applyPermissionMode, normalizePermissionMode } from "./permission-modes.js";
 import { normalizeDynamicStepsMode } from "./step-budget-controller.js";
 
@@ -78,7 +78,7 @@ export function resolveRuntimeConfig(args, overrides = {}) {
     auxiliaryModel: overrides.auxiliaryModel || args.auxiliaryModel || process.env.AGINTI_AUX_MODEL || "",
   });
 
-  const scsMode = normalizeScsMode(overrides.enableScs ?? args.enableScs ?? process.env.AGINTI_SCS_MODE ?? "on");
+  const scsMode = normalizeScsMode(overrides.enableScs ?? args.enableScs ?? process.env.AGINTI_SCS_MODE ?? DEFAULT_SCS_MODE);
   const scsActive = shouldActivateScs(scsMode, {
     goal: args.goal || "",
     taskProfile,

package/src/interactive-cli.js

@@ -35,7 +35,7 @@ import {
   setSkillMeshMode,
   skillMeshModeChoices,
 } from "./skillmesh.js";
-import { normalizeScsMode } from "./scs-controller.js";
+import { DEFAULT_SCS_MODE, normalizeScsMode } from "./scs-controller.js";
 import { formatAapsResult, runAapsAction } from "./aaps-adapter.js";
 import { formatInstructionTemplateList, normalizeInstructionTemplate } from "./behavior-contract.js";
 import {
@@ -2658,7 +2658,7 @@ function createState(args = {}) {
     allowWebSearch: args.allowWebSearch ?? true,
     allowMcpTools: args.allowMcpTools ?? true,
     allowParallelScouts: args.allowParallelScouts ?? true,
-    enableScs: normalizeScsMode(args.enableScs || process.env.AGINTI_SCS_MODE || "on"),
+    enableScs: normalizeScsMode(args.enableScs || process.env.AGINTI_SCS_MODE || DEFAULT_SCS_MODE),
     parallelScoutCount: args.parallelScoutCount || 3,
     allowWrapperTools: args.allowWrapperTools ?? isWrapperAvailable(args.preferredWrapper || "codex"),
     allowDestructive: args.allowDestructive ?? permissionDefaults.allowDestructive ?? false,

package/src/scs-controller.js

@@ -14,40 +14,38 @@ import {
 } from "./scs-evidence.js";
 
 export const SCS_MODES = ["off", "on", "auto"];
+export const DEFAULT_SCS_MODE = "auto";
 
-const COMPLEX_AUTO_PROFILES = new Set([
+const SCS_AUTO_PROFILES = new Set([
   "android",
   "app",
-  "book",
-  "code",
   "codebase",
   "database",
   "devops",
   "github",
   "ios",
   "large-codebase",
-  "latex",
   "maintenance",
-  "novel",
-  "paper",
+  "pipeline",
   "qa",
-  "research",
-  "review",
   "security",
   "supervision",
   "website",
-  "writing",
 ]);
 
-const COMPLEX_AUTO_HINTS = [
-  /\b(complex|complicated|large|multi[- ]file|cross[- ]file|repo[- ]wide|workspace[- ]wide)\b/i,
-  /\b(implement|refactor|debug|failing|regression|root cause|test|build|compile|migrate)\b/i,
-  /\b(android|ios|gradle|xcode|docker|systemd|github|pull request|release|deploy|latex|pdf)\b/i,
-  /\b(supervise|monitor|long[- ]running|resume|tmux|simulator|emulator)\b/i,
+const SCS_AUTO_HINTS = [
+  /\b(large|big|complex|complicated)\s+(repo|repository|codebase|project|task|migration|refactor)\b/i,
+  /\b(multi[- ]file|cross[- ]file|repo[- ]wide|workspace[- ]wide)\b/i,
+  /\b(root cause|regression|failing tests?|fix the build|make it pass|self[- ]debug|test[- ]debug[- ]validate|tdv)\b/i,
+  /\b(release|publish|deploy|migration|database migration|schema migration|production|rollback|ci|github|pull request)\b/i,
+  /\b(android|ios|gradle|xcode|docker|systemd|kubernetes|nginx|postgres|redis|toolchain|permission denied)\b/i,
+  /\b(supervise|monitor|long[- ]running|background|resume|tmux|simulator|emulator|pipeline|watchdog)\b/i,
   /\b(browser|web[- ]?ui|website|chrome|chromedriver|cdp|devtools|playwright|selenium|puppeteer)\b/i,
-  /\b(upload|attach|asset library|submit|publish|poll|download|reference video|reference image)\b/i,
-  /\b(novel|book|chapter|manuscript|screenplay|story bible|long[- ]form|research paper)\b/i,
-  /浏览器|网页|上传|提交|发布|素材库|资产库|参考图|参考视频|按钮|登录|验证码|积分/,
+  /\b(upload|attach|asset library|submit|poll|download|reference video|reference image|visual evidence)\b/i,
+  /\b(latex|pdflatex|latexmk|compile)\b.{0,80}\b(pdf|paper|manuscript|report)\b/i,
+  /\b(write|create|generate|produce)\b.{0,80}\b(pdf|compiled artifact|zip|dataset|database|csv|json|figure|plot|report)\b/i,
+  /\b(commit|push|npm publish|trusted publishing|release workflow|install globally)\b/i,
+  /浏览器|网页|上传|提交|发布|素材库|资产库|参考图|参考视频|按钮|登录|验证码|积分|编译|部署|回滚/,
 ];
 
 function compact(value = "", limit = 1200) {
@@ -181,9 +179,9 @@ export function shouldActivateScs(mode = "off", context = {}) {
 
   const profile = String(context.taskProfile || "").toLowerCase();
   const goal = String(context.goal || "");
-  if (Number(context.complexityScore || 0) >= 3) return true;
-  if (COMPLEX_AUTO_PROFILES.has(profile)) return true;
-  return COMPLEX_AUTO_HINTS.some((hint) => hint.test(goal));
+  if (SCS_AUTO_PROFILES.has(profile)) return true;
+  if (SCS_AUTO_HINTS.some((hint) => hint.test(goal))) return true;
+  return Number(context.complexityScore || 0) >= 5;
 }
 
 function fallbackPlan(goal = "") {
@@ -738,7 +736,7 @@ async function createScsPhase(client, config, state, context = {}, options = {})
 
   const scs = {
     enabled: true,
-    mode: config.enableScs || "on",
+    mode: config.enableScs || DEFAULT_SCS_MODE,
     active: true,
     model: `${config.provider}/${config.model}`,
     phase,

package/src/web-db.js

@@ -6,8 +6,9 @@ import { projectPaths } from "./project.js";
 import { deleteSessionIndex, renameSessionIndex, upsertSessionIndex } from "./session-index.js";
 import { loadDatabaseSync } from "./sqlite.js";
 import { permissionModeDefaults } from "./permission-modes.js";
+import { DEFAULT_SCS_MODE } from "./scs-controller.js";
 
-const PREFERENCES_SCHEMA_VERSION = 10;
+const PREFERENCES_SCHEMA_VERSION = 11;
 
 function jsonStatePath(dbPath) {
   return dbPath.replace(/\.sqlite$/i, ".json");
@@ -71,7 +72,7 @@ function defaultPreferences(baseDir) {
     allowAuxiliaryTools: true,
     allowWebSearch: true,
     allowParallelScouts: true,
-    enableScs: process.env.AGINTI_SCS_MODE || "on",
+    enableScs: process.env.AGINTI_SCS_MODE || DEFAULT_SCS_MODE,
     dynamicSteps: process.env.AGINTI_DYNAMIC_STEPS || "auto",
     veniceMode: false,
     parallelScoutCount: 3,
@@ -226,7 +227,7 @@ export class WebDatabase {
           preferences.allowOutsideWorkspaceFileTools = permissions.allowOutsideWorkspaceFileTools;
         }
         if ((parsed.preferencesSchemaVersion || 1) < 9) {
-          preferences.enableScs = preferences.enableScs || process.env.AGINTI_SCS_MODE || "on";
+          preferences.enableScs = preferences.enableScs || process.env.AGINTI_SCS_MODE || DEFAULT_SCS_MODE;
           preferences.dynamicSteps = preferences.dynamicSteps || process.env.AGINTI_DYNAMIC_STEPS || "auto";
         }
         if ((parsed.preferencesSchemaVersion || 1) < 10) {
@@ -243,6 +244,9 @@ export class WebDatabase {
             preferences.mainModel = "deepseek-v4-pro";
           }
         }
+        if ((parsed.preferencesSchemaVersion || 1) < 11 && !process.env.AGINTI_SCS_MODE && (parsed.enableScs || preferences.enableScs) === "on") {
+          preferences.enableScs = DEFAULT_SCS_MODE;
+        }
         this.savePreferences(preferences);
       }
       if (

package/web.js

@@ -27,7 +27,7 @@ import {
   normalizePermissionMode,
   permissionModeForApprovalCategory,
 } from "./src/permission-modes.js";
-import { normalizeScsMode } from "./src/scs-controller.js";
+import { DEFAULT_SCS_MODE, normalizeScsMode } from "./src/scs-controller.js";
 import { normalizeDynamicStepsMode } from "./src/step-budget-controller.js";
 import {
   ensureProjectSessionStorage,
@@ -566,7 +566,7 @@ function normalizePreferencePayload(body = {}, current = db.getPreferences()) {
       typeof body.allowMcpTools === "boolean" ? body.allowMcpTools : current.allowMcpTools !== false,
     allowParallelScouts:
       typeof body.allowParallelScouts === "boolean" ? body.allowParallelScouts : current.allowParallelScouts !== false,
-    enableScs: normalizeScsMode(body.enableScs || current.enableScs || process.env.AGINTI_SCS_MODE || "on"),
+    enableScs: normalizeScsMode(body.enableScs || current.enableScs || process.env.AGINTI_SCS_MODE || DEFAULT_SCS_MODE),
     dynamicSteps: normalizeDynamicStepsMode(body.dynamicSteps || current.dynamicSteps || process.env.AGINTI_DYNAMIC_STEPS || "auto"),
     veniceMode: typeof body.veniceMode === "boolean" ? body.veniceMode : current.veniceMode === true,
     parallelScoutCount: