openshain 0.4.0 → 0.5.0

package/dist/bin.js

@@ -4,6 +4,8 @@ import { anthropicProvider, openaiCompatibleProvider } from "@openshain/agent";
 import { isOpenshainError } from "@openshain/core";
 import { standardTools } from "@openshain/tools";
 import { init } from "./commands/init.js";
+import { knowledgeBuild, knowledgeCheck } from "./commands/knowledge.js";
+import { knowledgeAdd } from "./commands/knowledge-add.js";
 import { mcp } from "./commands/mcp.js";
 import { toolsList } from "./commands/tools.js";
 import { workList, workShow } from "./commands/work.js";
@@ -17,6 +19,9 @@ const USAGE = `使い方:
   openshain tools list           使える Tool の一覧
   openshain work list            Work の一覧
   openshain work show <id>       Work の詳細
+  openshain knowledge build      knowledge/ の決まりと資料を検証して索引を作る
+  openshain knowledge check      同じ検証を、索引を書かずに行う(--stale で古い資料も報告)
+  openshain knowledge add        決まりを 1 件、質問に答えて追加する
   openshain mcp                  MCP Server を stdio で起動する
 
   --workspace <dir>              起点のディレクトリ。省略時はカレントディレクトリ
@@ -27,7 +32,7 @@ const providers = {
         anthropic: (model) => anthropicProvider(model),
         "openai-compatible": (model) => openaiCompatibleProvider(model),
     },
-    tools: { standard: () => standardTools() },
+    tools: { standard: (workspaceRoot) => standardTools(workspaceRoot) },
 };
 async function main(argv) {
     const write = (line) => console.log(plain(line));
@@ -36,7 +41,11 @@ async function main(argv) {
     try {
         ({ values, positionals } = parseArgs({
             args: argv,
-            options: { workspace: { type: "string" }, help: { type: "boolean", short: "h" } },
+            options: {
+                workspace: { type: "string" },
+                help: { type: "boolean", short: "h" },
+                stale: { type: "boolean" },
+            },
             allowPositionals: true,
         }));
     }
@@ -75,6 +84,18 @@ async function main(argv) {
             await toolsList({ workspaceRoot, providers, write });
             return 0;
         }
+        case "knowledge": {
+            const sub = rest[0];
+            if (!(sub === "build" || sub === "check" || sub === "add")) {
+                write(USAGE);
+                return 2;
+            }
+            const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+            if (sub === "add")
+                return await knowledgeAdd({ workspaceRoot, write });
+            const run = sub === "build" ? knowledgeBuild : knowledgeCheck;
+            return await run({ workspaceRoot, write, ...(values.stale === true && { stale: true }) });
+        }
         case "work": {
             const sub = rest[0];
             const id = rest[1] ?? "";

package/dist/commands/init.d.ts

@@ -1,7 +1,7 @@
 import { type Language } from "@openshain/core";
 /** The company's language for the template: from the OS locale, Japanese unless the locale says otherwise. */
 export declare function detectLanguage(env: Record<string, string | undefined>): Language;
-export declare const configTemplate: (language: Language) => string;
+export declare const configTemplate: (language: Language, timezone: string) => string;
 export declare const CONFIG_TEMPLATE: string;
 /** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
 export declare const MCP_TEMPLATE: string;

package/dist/commands/init.js

@@ -1,6 +1,6 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { CONFIG_FILE_NAME, OpenshainError } from "@openshain/core";
+import { CONFIG_FILE_NAME, hostTimezone, OpenshainError } from "@openshain/core";
 /** The company's language for the template: from the OS locale, Japanese unless the locale says otherwise. */
 export function detectLanguage(env) {
     const raw = env.LC_ALL || env.LC_MESSAGES || env.LANG || "";
@@ -9,10 +9,11 @@ export function detectLanguage(env) {
         return "ja";
     return "en";
 }
-export const configTemplate = (language) => `version: 1
+export const configTemplate = (language, timezone) => `version: 1
 company:
   name: サンプル株式会社   # 会社名。model に伝わる
   language: ${language}             # ja | en。社員エージェントの名前の言語。init が OS の locale から埋める
+  timezone: ${timezone}   # 会社の時刻。業務日と有効日はこれで決まる。init がこの機械の設定から埋める
 principal:
   id: alice                # 依頼する人の id。小文字の英数字、_ と -
   name: Alice
@@ -27,6 +28,7 @@ model:
   api_key_env: ANTHROPIC_API_KEY   # API キーを入れておく環境変数の名前。サーバーを替えるなら変数名も見直す
   # base_url: http://localhost:11434/v1   # openai-compatible のとき
   # options: { effort: high }             # provider にそのまま渡す
+  # context_tokens: 200000                # このモデルが受け取れる入力の大きさ。会話を要約する目安に使う
 tools:
   - provider: standard
     # allow: [fs_list, fs_search, fs_read, csv_read, csv_aggregate, markdown_read, fs_write, csv_write]   # 省略時は全部
@@ -35,10 +37,11 @@ limits:
   max_model_calls: 30      # 超えると Work は失敗(上限到達)で止まる
   max_tool_calls: 100
   max_output_tokens: 16000 # model の 1 回の出力の上限
+  # compact_at_input_tokens: 150000   # ここを超えたら次のターンの前に会話を要約する。0 で要約しない
 # debug:
 #   persist_raw: true      # provider の生の応答を記録に残す
 `;
-export const CONFIG_TEMPLATE = configTemplate("ja");
+export const CONFIG_TEMPLATE = configTemplate("ja", "Asia/Tokyo");
 /** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
 export const MCP_TEMPLATE = `${JSON.stringify({ mcpServers: { openshain: { command: "openshain", args: ["mcp"] } } }, null, 2)}\n`;
 /** What an outside agent reads before working in the folder. Codex reads AGENTS.md; Claude Code reads it through CLAUDE.md. */
@@ -65,7 +68,9 @@ export const CLAUDE_TEMPLATE = "@AGENTS.md\n";
 export async function init({ workspaceRoot, write }) {
     const configPath = join(workspaceRoot, CONFIG_FILE_NAME);
     try {
-        await writeFile(configPath, configTemplate(detectLanguage(process.env)), { flag: "wx" });
+        await writeFile(configPath, configTemplate(detectLanguage(process.env), hostTimezone()), {
+            flag: "wx",
+        });
     }
     catch (err) {
         const code = err.code;

package/dist/commands/knowledge-add.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Adding one rule by answering questions, so that a person does not have to learn the shape of
+ * the file to write one. Nothing is written until the rule holds up against everything already
+ * there: a rule that would break the build never reaches the folder, so adding one can only
+ * succeed or leave the company's knowledge exactly as it was.
+ */
+export interface KnowledgeAddOptions {
+    workspaceRoot: string;
+    write: (line: string) => void;
+    /** Asks the person one question and returns what they typed. Given by the terminal. */
+    ask?: (question: string) => Promise<string>;
+    /** Whether a person is there to answer. */
+    interactive?: boolean;
+    today?: string;
+}
+export declare function knowledgeAdd(options: KnowledgeAddOptions): Promise<number>;

package/dist/commands/knowledge-add.js

@@ -0,0 +1,91 @@
+import { createInterface } from "node:readline/promises";
+import { checkKnowledge, KNOWLEDGE_DIR_NAME, knowledgePath, readKnowledgeFile, writeKnowledgeFile, } from "@openshain/core";
+import { knowledgeBuild } from "./knowledge.js";
+export async function knowledgeAdd(options) {
+    const { write } = options;
+    const interactive = options.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    if (!interactive) {
+        write("openshain knowledge add は端末で使います。決まりを直接書くなら knowledge/rules/ です。");
+        return 2;
+    }
+    const readline = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = options.ask ?? ((question) => readline.question(`${question}\n> `));
+    try {
+        return await run({ ...options, ask }, write);
+    }
+    finally {
+        readline.close();
+    }
+}
+async function run(options, write) {
+    const { workspaceRoot, ask } = options;
+    const today = options.today ?? new Date().toISOString().slice(0, 10);
+    const existing = await checkKnowledge(workspaceRoot);
+    if (existing.sources.length === 0) {
+        write(`根拠になる資料がまだありません。${KNOWLEDGE_DIR_NAME}/sources/ に 1 件置いてから実行してください。`);
+        return 1;
+    }
+    write("会社の決まりを 1 件追加します。答えたくない項目は空のまま Enter で戻れます。");
+    const statement = (await ask("どんな決まりですか。1 文で書いてください")).trim();
+    if (statement === "") {
+        write("何も書かれなかったので、やめました。");
+        return 1;
+    }
+    const id = (await ask("この決まりの id(例 expenses.receipt-required)")).trim();
+    const from = (await ask(`いつから有効ですか(YYYY-MM-DD。空なら ${today})`)).trim() || today;
+    const to = (await ask("いつまでですか(期限がなければ空のまま)")).trim();
+    write("根拠にする資料を選んでください。");
+    for (const source of existing.sources)
+        write(`  ${source.id}  ${source.title}`);
+    const sourceId = (await ask("資料の id")).trim();
+    const section = (await ask("その資料のどの節ですか(なければ空のまま)")).trim();
+    const aliases = (await ask("他にどう言い換えますか(読点で区切ります。なければ空のまま)"))
+        .split(/[,、]/)
+        .map((word) => word.trim())
+        .filter(Boolean);
+    const expertise = (await ask("資格者の領域に関わりますか(none、tax、legal、labor など。空なら none)")).trim() ||
+        "none";
+    const rule = {
+        id,
+        statement,
+        ...(aliases.length > 0 && { aliases }),
+        effective_from: from,
+        effective_to: to === "" ? null : to,
+        expertise,
+        source: { id: sourceId, ...(section !== "" && { section }) },
+    };
+    // The file it would live in, named after what the id is about.
+    const parts = ["rules", `${(id.split(".")[0] || "rules").replace(/[^a-z0-9-]/g, "")}.yaml`];
+    const file = knowledgePath(parts);
+    const checked = await checkKnowledge(workspaceRoot, {
+        adding: [{ ...rule, file }],
+    });
+    if (checked.problems.length > 0) {
+        for (const problem of checked.problems)
+            write(problem);
+        write("この決まりは追加していません。会社の決まりはそのままです。");
+        return 1;
+    }
+    const before = await readKnowledgeFile(workspaceRoot, parts);
+    await writeKnowledgeFile(workspaceRoot, parts, appended(before, rule));
+    write(`${file} に ${id} を書きました。`);
+    return knowledgeBuild({ workspaceRoot, write });
+}
+/** The rule as a person would have written it, added to the file or starting one. */
+function appended(before, rule) {
+    const lines = [
+        `  - id: ${rule.id}`,
+        `    statement: ${quoted(rule.statement)}`,
+        ...(rule.aliases ? [`    aliases: [${rule.aliases.map(quoted).join(", ")}]`] : []),
+        `    effective_from: ${rule.effective_from}`,
+        `    effective_to: ${rule.effective_to === null ? "null" : rule.effective_to}`,
+        `    expertise: ${rule.expertise}`,
+        `    source: { id: ${rule.source.id}${rule.source.section ? `, section: ${quoted(rule.source.section)}` : ""} }`,
+    ];
+    const head = before?.trimEnd() ?? "version: 1\nrules:";
+    return `${head}\n${lines.join("\n")}\n`;
+}
+/** YAML that means the string and nothing else, whatever is in it. */
+function quoted(text) {
+    return `"${text.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}

package/dist/commands/knowledge.d.ts

@@ -0,0 +1,15 @@
+export interface KnowledgeOptions {
+    workspaceRoot: string;
+    write: (line: string) => void;
+    /** Also say which sources have not been looked at for a year. Never changes the outcome. */
+    stale?: boolean;
+    now?: Date;
+}
+/**
+ * Checks what a person wrote and, when nothing is wrong, writes the index. Every problem is
+ * printed, not only the first: a person fixing a set of files should need one pass, not one run
+ * per mistake. When anything is wrong, `knowledge/build/` is left exactly as it was.
+ */
+export declare function knowledgeBuild(options: KnowledgeOptions): Promise<number>;
+/** The same checks without writing anything, for a person or for CI. */
+export declare function knowledgeCheck(options: KnowledgeOptions): Promise<number>;

package/dist/commands/knowledge.js

@@ -0,0 +1,62 @@
+import { buildIndex, checkKnowledge, hashKnowledgeInput, hasKnowledge, KNOWLEDGE_DIR_NAME, writeIndex, } from "@openshain/core";
+/** A year is how long a company's source may sit before it is worth looking at again. */
+const STALE_DAYS = 365;
+/**
+ * Checks what a person wrote and, when nothing is wrong, writes the index. Every problem is
+ * printed, not only the first: a person fixing a set of files should need one pass, not one run
+ * per mistake. When anything is wrong, `knowledge/build/` is left exactly as it was.
+ */
+export async function knowledgeBuild(options) {
+    const { workspaceRoot, write } = options;
+    if (!(await hasKnowledge(workspaceRoot))) {
+        write(`${KNOWLEDGE_DIR_NAME}/ がありません。会社の決まりは ${KNOWLEDGE_DIR_NAME}/rules/、根拠の資料は ${KNOWLEDGE_DIR_NAME}/sources/ に置きます。`);
+        return 1;
+    }
+    const checked = await checkKnowledge(workspaceRoot);
+    if (checked.problems.length > 0) {
+        for (const problem of checked.problems)
+            write(problem);
+        write(`${checked.problems.length} 件の問題があります。索引は作りませんでした。`);
+        return 1;
+    }
+    if (options.stale)
+        for (const line of staleLines(checked.sources, options.now))
+            write(line);
+    const manifest = await writeIndex(workspaceRoot, buildIndex(checked), {
+        hash: await hashKnowledgeInput(workspaceRoot),
+        rules: checked.rules.length,
+        sources: checked.sources.length,
+    });
+    write(`決まり ${manifest.rules} 件、資料 ${manifest.sources} 件から ${manifest.units} 件の索引を作りました。`);
+    write("対話を開いている場合は、いったん閉じて開き直すと社員エージェントが引けるようになります。");
+    return 0;
+}
+/** The same checks without writing anything, for a person or for CI. */
+export async function knowledgeCheck(options) {
+    const { workspaceRoot, write } = options;
+    if (!(await hasKnowledge(workspaceRoot))) {
+        write(`${KNOWLEDGE_DIR_NAME}/ がありません。`);
+        return 1;
+    }
+    const checked = await checkKnowledge(workspaceRoot);
+    for (const problem of checked.problems)
+        write(problem);
+    if (options.stale)
+        for (const line of staleLines(checked.sources, options.now))
+            write(line);
+    if (checked.problems.length > 0) {
+        write(`${checked.problems.length} 件の問題があります。`);
+        return 1;
+    }
+    write(`決まり ${checked.rules.length} 件、資料 ${checked.sources.length} 件。問題はありません。`);
+    return 0;
+}
+/** Sources nobody has looked at for a year. A warning, never a reason to fail. */
+function staleLines(sources, now = new Date()) {
+    const limit = new Date(now);
+    limit.setUTCDate(limit.getUTCDate() - STALE_DAYS);
+    const cutoff = limit.toISOString().slice(0, 10);
+    return sources
+        .filter((source) => source.retrieved_at < cutoff)
+        .map((source) => `${source.file}: ${source.id} を確かめたのは ${source.retrieved_at} です。出どころが変わっていないか確認してください。`);
+}

package/dist/labels.js

@@ -32,6 +32,7 @@ export const ERROR_LABELS = {
     auth: "認証の失敗",
     network: "接続の失敗",
     rate_limit: "呼び出し上限",
+    too_large: "入力が大きすぎる",
     invalid_response: "解釈できない model の応答",
     config: "設定の問題",
     corrupt_log: "壊れた Work の記録",

package/dist/preview.js

@@ -1,5 +1,4 @@
-import { readFile } from "node:fs/promises";
-import { resolveWorkspacePath } from "@openshain/core";
+import { readWorkspaceTextIfAny, resolveWorkspacePath } from "@openshain/core";
 import { csvText } from "@openshain/tools";
 /** How much of a change the screen shows before it says the rest is cut. */
 const MAX_LINES = 24;
@@ -30,9 +29,8 @@ export async function previewCall(workspaceRoot, call) {
     // The same guard the tools run under: a path outside the workspace, a reserved one or a
     // symlink that leads out is refused here too, so the screen never shows what the call cannot
     // touch. The model chooses this path; the person is about to read what it says.
-    let resolved;
     try {
-        resolved = await resolveWorkspacePath(workspaceRoot, path);
+        await resolveWorkspacePath(workspaceRoot, path);
     }
     catch (err) {
         return [
@@ -42,7 +40,7 @@ export async function previewCall(workspaceRoot, call) {
             },
         ];
     }
-    const before = await readFile(resolved, "utf8").catch(() => undefined);
+    const before = await readWorkspaceTextIfAny(workspaceRoot, path);
     if (before === undefined) {
         const lines = content.split("\n");
         return cap([

package/dist/tui/controller.d.ts

@@ -1,4 +1,4 @@
-import { type ApprovalChoice } from "@openshain/agent";
+import { type ApprovalChoice, type CompactionOutcome } from "@openshain/agent";
 import { type RuntimeProviders, type WorkId, WorkStore } from "@openshain/core";
 import { statusLabel } from "../labels.ts";
 import { type PreviewLine } from "../preview.ts";
@@ -70,6 +70,11 @@ export interface ControllerOptions {
     workspaceRoot: string;
     providers: RuntimeProviders;
 }
+/**
+ * What the screen says when the conversation was summarized. The person cannot read the summary
+ * itself, so the line carries what they told the agent: that is the part they can check.
+ */
+export declare function compactionLine(outcome: CompactionOutcome): string;
 /**
  * The state behind the screen: a session, the works it starts, and the lines to show. The
  * conversation reaches the runtime only as an MCP client of the workspace's own server, the way

package/dist/tui/controller.js

@@ -8,6 +8,51 @@ import { statusLabel } from "../labels.js";
 import { previewCall } from "../preview.js";
 import { progressLine, report } from "../report.js";
 import { LOGO_ROWS, VERSION } from "./banner.js";
+/**
+ * What the screen says when the conversation was summarized. The person cannot read the summary
+ * itself, so the line carries what they told the agent: that is the part they can check.
+ */
+export function compactionLine(outcome) {
+    if (!outcome.done) {
+        switch (outcome.reason) {
+            case "nothing_to_compact":
+                return "まだ要約するところがありません。";
+            case "no_smaller":
+                return "この会話はこれ以上要約できません。いったん終えて、新しく始めるほうが確かです。";
+            case "empty":
+                return "要約が空だったので、会話はそのままです。";
+            case "secret":
+                return "要約に鍵らしき文字列が入ったので、記録しませんでした。会話はそのままです。";
+            default:
+                return `要約に失敗したので、会話はそのままです。${outcome.detail ?? ""}`.trim();
+        }
+    }
+    const assumed = heading(outcome.summary, "人が伝えた前提");
+    const kept = assumed ? `。人が伝えた前提: ${assumed}` : "";
+    return `会話を要約しました(${outcome.covered} 件を 1 件に)${kept}`;
+}
+/** What one heading of a summary says, in one line and at most this long. */
+function heading(summary, name) {
+    const lines = summary.split("\n");
+    const at = lines.findIndex((line) => line.includes(name));
+    if (at < 0)
+        return undefined;
+    const said = [];
+    for (const line of lines.slice(at + 1)) {
+        const text = line.replace(/^[#\s*-]+/, "").trim();
+        if (text === "")
+            continue;
+        if (/^#/.test(line) || /^\*\*/.test(line))
+            break;
+        said.push(text);
+        if (said.join("、").length > 120)
+            break;
+    }
+    const all = said.join("、");
+    if (all === "" || all === "なし")
+        return undefined;
+    return all.length > 120 ? `${all.slice(0, 120)}…` : all;
+}
 const HELP = [
     "/work list         Work の一覧",
     "/work show <id>    Work の詳細",
@@ -15,6 +60,7 @@ const HELP = [
     "/approvals         承認待ちの一覧",
     "/approve <id>      承認して実行する。/reject <id> [理由] で拒否する",
     "/review <id> approve|reject  資格者の判断を記録する。名前と本文を順に聞く",
+    "/compact           会話を要約して短くする。長い会話は自動でも要約される",
     "/tools             使える Tool",
     "/quit              終わる",
     "↑ ↓                前に送った行を入力欄に呼び戻す。いちばん下は新しい入力",
@@ -317,6 +363,10 @@ export async function createController(options) {
             await close();
         else if (name === "tools")
             await capture((write) => toolsList({ ...options, write }));
+        else if (name === "compact") {
+            const outcome = await session.compact();
+            push(outcome.done ? "progress" : "notice", compactionLine(outcome));
+        }
         else if (name === "work" && sub === "list")
             await capture((write) => workList({ workspaceRoot: options.workspaceRoot, write }));
         else if (name === "work" && (sub === "show" || sub === "resume") && !args[1])
@@ -464,6 +514,9 @@ export async function createController(options) {
             await stoppable(async (signal) => {
                 try {
                     const result = await session.turn(text, { signal });
+                    if (result.compacted) {
+                        push(result.compacted.done ? "progress" : "notice", compactionLine(result.compacted));
+                    }
                     // What the work recorded is the agent's own writing, so it stands in when the turn
                     // ends with nothing said. Without this the person is left with a work that finished
                     // and no answer, which is what a model that skips its summary leaves behind.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openshain",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Reference CLI of the openshain agent harness",
   "keywords": [
     "openshain",
@@ -49,10 +49,10 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@openshain/agent": "0.4.0",
-    "@openshain/core": "0.4.0",
-    "@openshain/mcp": "0.4.0",
-    "@openshain/tools": "0.4.0",
+    "@openshain/agent": "0.5.0",
+    "@openshain/core": "0.5.0",
+    "@openshain/mcp": "0.5.0",
+    "@openshain/tools": "0.5.0",
     "ink": "7.1.1",
     "marked": "18.0.12",
     "react": "19.2.8"

package/src/bin.ts

@@ -4,6 +4,8 @@ import { anthropicProvider, openaiCompatibleProvider } from "@openshain/agent";
 import { isOpenshainError, type RuntimeProviders } from "@openshain/core";
 import { standardTools } from "@openshain/tools";
 import { init } from "./commands/init.ts";
+import { knowledgeBuild, knowledgeCheck } from "./commands/knowledge.ts";
+import { knowledgeAdd } from "./commands/knowledge-add.ts";
 import { mcp } from "./commands/mcp.ts";
 import { toolsList } from "./commands/tools.ts";
 import { workList, workShow } from "./commands/work.ts";
@@ -18,6 +20,9 @@ const USAGE = `使い方:
   openshain tools list           使える Tool の一覧
   openshain work list            Work の一覧
   openshain work show <id>       Work の詳細
+  openshain knowledge build      knowledge/ の決まりと資料を検証して索引を作る
+  openshain knowledge check      同じ検証を、索引を書かずに行う(--stale で古い資料も報告)
+  openshain knowledge add        決まりを 1 件、質問に答えて追加する
   openshain mcp                  MCP Server を stdio で起動する
 
   --workspace <dir>              起点のディレクトリ。省略時はカレントディレクトリ
@@ -29,17 +34,21 @@ const providers: RuntimeProviders = {
     anthropic: (model) => anthropicProvider(model),
     "openai-compatible": (model) => openaiCompatibleProvider(model),
   },
-  tools: { standard: () => standardTools() },
+  tools: { standard: (workspaceRoot) => standardTools(workspaceRoot) },
 };
 
 async function main(argv: string[]): Promise<number> {
   const write = (line: string) => console.log(plain(line));
-  let values: { workspace?: string; help?: boolean };
+  let values: { workspace?: string; help?: boolean; stale?: boolean };
   let positionals: string[];
   try {
     ({ values, positionals } = parseArgs({
       args: argv,
-      options: { workspace: { type: "string" }, help: { type: "boolean", short: "h" } },
+      options: {
+        workspace: { type: "string" },
+        help: { type: "boolean", short: "h" },
+        stale: { type: "boolean" },
+      },
       allowPositionals: true,
     }));
   } catch (err) {
@@ -77,6 +86,17 @@ async function main(argv: string[]): Promise<number> {
       await toolsList({ workspaceRoot, providers, write });
       return 0;
     }
+    case "knowledge": {
+      const sub = rest[0];
+      if (!(sub === "build" || sub === "check" || sub === "add")) {
+        write(USAGE);
+        return 2;
+      }
+      const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+      if (sub === "add") return await knowledgeAdd({ workspaceRoot, write });
+      const run = sub === "build" ? knowledgeBuild : knowledgeCheck;
+      return await run({ workspaceRoot, write, ...(values.stale === true && { stale: true }) });
+    }
     case "work": {
       const sub = rest[0];
       const id = rest[1] ?? "";

package/src/commands/init.ts

@@ -1,6 +1,6 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { CONFIG_FILE_NAME, type Language, OpenshainError } from "@openshain/core";
+import { CONFIG_FILE_NAME, hostTimezone, type Language, OpenshainError } from "@openshain/core";
 
 /** The company's language for the template: from the OS locale, Japanese unless the locale says otherwise. */
 export function detectLanguage(env: Record<string, string | undefined>): Language {
@@ -10,10 +10,11 @@ export function detectLanguage(env: Record<string, string | undefined>): Languag
   return "en";
 }
 
-export const configTemplate = (language: Language) => `version: 1
+export const configTemplate = (language: Language, timezone: string) => `version: 1
 company:
   name: サンプル株式会社   # 会社名。model に伝わる
   language: ${language}             # ja | en。社員エージェントの名前の言語。init が OS の locale から埋める
+  timezone: ${timezone}   # 会社の時刻。業務日と有効日はこれで決まる。init がこの機械の設定から埋める
 principal:
   id: alice                # 依頼する人の id。小文字の英数字、_ と -
   name: Alice
@@ -28,6 +29,7 @@ model:
   api_key_env: ANTHROPIC_API_KEY   # API キーを入れておく環境変数の名前。サーバーを替えるなら変数名も見直す
   # base_url: http://localhost:11434/v1   # openai-compatible のとき
   # options: { effort: high }             # provider にそのまま渡す
+  # context_tokens: 200000                # このモデルが受け取れる入力の大きさ。会話を要約する目安に使う
 tools:
   - provider: standard
     # allow: [fs_list, fs_search, fs_read, csv_read, csv_aggregate, markdown_read, fs_write, csv_write]   # 省略時は全部
@@ -36,11 +38,12 @@ limits:
   max_model_calls: 30      # 超えると Work は失敗(上限到達)で止まる
   max_tool_calls: 100
   max_output_tokens: 16000 # model の 1 回の出力の上限
+  # compact_at_input_tokens: 150000   # ここを超えたら次のターンの前に会話を要約する。0 で要約しない
 # debug:
 #   persist_raw: true      # provider の生の応答を記録に残す
 `;
 
-export const CONFIG_TEMPLATE = configTemplate("ja");
+export const CONFIG_TEMPLATE = configTemplate("ja", "Asia/Tokyo");
 
 /** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
 export const MCP_TEMPLATE = `${JSON.stringify(
@@ -80,7 +83,9 @@ export interface InitOptions {
 export async function init({ workspaceRoot, write }: InitOptions): Promise<void> {
   const configPath = join(workspaceRoot, CONFIG_FILE_NAME);
   try {
-    await writeFile(configPath, configTemplate(detectLanguage(process.env)), { flag: "wx" });
+    await writeFile(configPath, configTemplate(detectLanguage(process.env), hostTimezone()), {
+      flag: "wx",
+    });
   } catch (err) {
     const code = (err as NodeJS.ErrnoException).code;
     if (code === "EEXIST") {

package/src/commands/knowledge-add.ts

@@ -0,0 +1,128 @@
+import { createInterface } from "node:readline/promises";
+import {
+  checkKnowledge,
+  KNOWLEDGE_DIR_NAME,
+  type KnowledgeRule,
+  knowledgePath,
+  type LoadedKnowledgeRule,
+  readKnowledgeFile,
+  writeKnowledgeFile,
+} from "@openshain/core";
+import { knowledgeBuild } from "./knowledge.ts";
+
+/**
+ * Adding one rule by answering questions, so that a person does not have to learn the shape of
+ * the file to write one. Nothing is written until the rule holds up against everything already
+ * there: a rule that would break the build never reaches the folder, so adding one can only
+ * succeed or leave the company's knowledge exactly as it was.
+ */
+
+export interface KnowledgeAddOptions {
+  workspaceRoot: string;
+  write: (line: string) => void;
+  /** Asks the person one question and returns what they typed. Given by the terminal. */
+  ask?: (question: string) => Promise<string>;
+  /** Whether a person is there to answer. */
+  interactive?: boolean;
+  today?: string;
+}
+
+export async function knowledgeAdd(options: KnowledgeAddOptions): Promise<number> {
+  const { write } = options;
+  const interactive = options.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  if (!interactive) {
+    write("openshain knowledge add は端末で使います。決まりを直接書くなら knowledge/rules/ です。");
+    return 2;
+  }
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = options.ask ?? ((question: string) => readline.question(`${question}\n> `));
+  try {
+    return await run({ ...options, ask }, write);
+  } finally {
+    readline.close();
+  }
+}
+
+async function run(
+  options: KnowledgeAddOptions & { ask: (question: string) => Promise<string> },
+  write: (line: string) => void,
+): Promise<number> {
+  const { workspaceRoot, ask } = options;
+  const today = options.today ?? new Date().toISOString().slice(0, 10);
+  const existing = await checkKnowledge(workspaceRoot);
+  if (existing.sources.length === 0) {
+    write(
+      `根拠になる資料がまだありません。${KNOWLEDGE_DIR_NAME}/sources/ に 1 件置いてから実行してください。`,
+    );
+    return 1;
+  }
+
+  write("会社の決まりを 1 件追加します。答えたくない項目は空のまま Enter で戻れます。");
+  const statement = (await ask("どんな決まりですか。1 文で書いてください")).trim();
+  if (statement === "") {
+    write("何も書かれなかったので、やめました。");
+    return 1;
+  }
+  const id = (await ask("この決まりの id(例 expenses.receipt-required)")).trim();
+  const from = (await ask(`いつから有効ですか(YYYY-MM-DD。空なら ${today})`)).trim() || today;
+  const to = (await ask("いつまでですか(期限がなければ空のまま)")).trim();
+
+  write("根拠にする資料を選んでください。");
+  for (const source of existing.sources) write(`  ${source.id}  ${source.title}`);
+  const sourceId = (await ask("資料の id")).trim();
+  const section = (await ask("その資料のどの節ですか(なければ空のまま)")).trim();
+  const aliases = (await ask("他にどう言い換えますか(読点で区切ります。なければ空のまま)"))
+    .split(/[,、]/)
+    .map((word) => word.trim())
+    .filter(Boolean);
+  const expertise =
+    (await ask("資格者の領域に関わりますか(none、tax、legal、labor など。空なら none)")).trim() ||
+    "none";
+
+  const rule = {
+    id,
+    statement,
+    ...(aliases.length > 0 && { aliases }),
+    effective_from: from,
+    effective_to: to === "" ? null : to,
+    expertise,
+    source: { id: sourceId, ...(section !== "" && { section }) },
+  } as KnowledgeRule;
+
+  // The file it would live in, named after what the id is about.
+  const parts = ["rules", `${(id.split(".")[0] || "rules").replace(/[^a-z0-9-]/g, "")}.yaml`];
+  const file = knowledgePath(parts);
+  const checked = await checkKnowledge(workspaceRoot, {
+    adding: [{ ...rule, file } as LoadedKnowledgeRule],
+  });
+  if (checked.problems.length > 0) {
+    for (const problem of checked.problems) write(problem);
+    write("この決まりは追加していません。会社の決まりはそのままです。");
+    return 1;
+  }
+
+  const before = await readKnowledgeFile(workspaceRoot, parts);
+  await writeKnowledgeFile(workspaceRoot, parts, appended(before, rule));
+  write(`${file} に ${id} を書きました。`);
+  return knowledgeBuild({ workspaceRoot, write });
+}
+
+/** The rule as a person would have written it, added to the file or starting one. */
+function appended(before: string | undefined, rule: KnowledgeRule): string {
+  const lines = [
+    `  - id: ${rule.id}`,
+    `    statement: ${quoted(rule.statement)}`,
+    ...(rule.aliases ? [`    aliases: [${rule.aliases.map(quoted).join(", ")}]`] : []),
+    `    effective_from: ${rule.effective_from}`,
+    `    effective_to: ${rule.effective_to === null ? "null" : rule.effective_to}`,
+    `    expertise: ${rule.expertise}`,
+    `    source: { id: ${rule.source.id}${rule.source.section ? `, section: ${quoted(rule.source.section)}` : ""} }`,
+  ];
+  const head = before?.trimEnd() ?? "version: 1\nrules:";
+  return `${head}\n${lines.join("\n")}\n`;
+}
+
+/** YAML that means the string and nothing else, whatever is in it. */
+function quoted(text: string): string {
+  return `"${text.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}

package/src/commands/knowledge.ts

@@ -0,0 +1,84 @@
+import {
+  buildIndex,
+  checkKnowledge,
+  hashKnowledgeInput,
+  hasKnowledge,
+  KNOWLEDGE_DIR_NAME,
+  type KnowledgeSource,
+  writeIndex,
+} from "@openshain/core";
+
+export interface KnowledgeOptions {
+  workspaceRoot: string;
+  write: (line: string) => void;
+  /** Also say which sources have not been looked at for a year. Never changes the outcome. */
+  stale?: boolean;
+  now?: Date;
+}
+
+/** A year is how long a company's source may sit before it is worth looking at again. */
+const STALE_DAYS = 365;
+
+/**
+ * Checks what a person wrote and, when nothing is wrong, writes the index. Every problem is
+ * printed, not only the first: a person fixing a set of files should need one pass, not one run
+ * per mistake. When anything is wrong, `knowledge/build/` is left exactly as it was.
+ */
+export async function knowledgeBuild(options: KnowledgeOptions): Promise<number> {
+  const { workspaceRoot, write } = options;
+  if (!(await hasKnowledge(workspaceRoot))) {
+    write(
+      `${KNOWLEDGE_DIR_NAME}/ がありません。会社の決まりは ${KNOWLEDGE_DIR_NAME}/rules/、根拠の資料は ${KNOWLEDGE_DIR_NAME}/sources/ に置きます。`,
+    );
+    return 1;
+  }
+  const checked = await checkKnowledge(workspaceRoot);
+  if (checked.problems.length > 0) {
+    for (const problem of checked.problems) write(problem);
+    write(`${checked.problems.length} 件の問題があります。索引は作りませんでした。`);
+    return 1;
+  }
+  if (options.stale) for (const line of staleLines(checked.sources, options.now)) write(line);
+
+  const manifest = await writeIndex(workspaceRoot, buildIndex(checked), {
+    hash: await hashKnowledgeInput(workspaceRoot),
+    rules: checked.rules.length,
+    sources: checked.sources.length,
+  });
+  write(
+    `決まり ${manifest.rules} 件、資料 ${manifest.sources} 件から ${manifest.units} 件の索引を作りました。`,
+  );
+  write("対話を開いている場合は、いったん閉じて開き直すと社員エージェントが引けるようになります。");
+  return 0;
+}
+
+/** The same checks without writing anything, for a person or for CI. */
+export async function knowledgeCheck(options: KnowledgeOptions): Promise<number> {
+  const { workspaceRoot, write } = options;
+  if (!(await hasKnowledge(workspaceRoot))) {
+    write(`${KNOWLEDGE_DIR_NAME}/ がありません。`);
+    return 1;
+  }
+  const checked = await checkKnowledge(workspaceRoot);
+  for (const problem of checked.problems) write(problem);
+  if (options.stale) for (const line of staleLines(checked.sources, options.now)) write(line);
+  if (checked.problems.length > 0) {
+    write(`${checked.problems.length} 件の問題があります。`);
+    return 1;
+  }
+  write(`決まり ${checked.rules.length} 件、資料 ${checked.sources.length} 件。問題はありません。`);
+  return 0;
+}
+
+/** Sources nobody has looked at for a year. A warning, never a reason to fail. */
+function staleLines(sources: KnowledgeSource[], now = new Date()): string[] {
+  const limit = new Date(now);
+  limit.setUTCDate(limit.getUTCDate() - STALE_DAYS);
+  const cutoff = limit.toISOString().slice(0, 10);
+  return sources
+    .filter((source) => source.retrieved_at < cutoff)
+    .map(
+      (source) =>
+        `${source.file}: ${source.id} を確かめたのは ${source.retrieved_at} です。出どころが変わっていないか確認してください。`,
+    );
+}

package/src/labels.ts

@@ -37,6 +37,7 @@ export const ERROR_LABELS: Record<ErrorCode, string> = {
   auth: "認証の失敗",
   network: "接続の失敗",
   rate_limit: "呼び出し上限",
+  too_large: "入力が大きすぎる",
   invalid_response: "解釈できない model の応答",
   config: "設定の問題",
   corrupt_log: "壊れた Work の記録",

package/src/preview.ts

@@ -1,5 +1,4 @@
-import { readFile } from "node:fs/promises";
-import { resolveWorkspacePath } from "@openshain/core";
+import { readWorkspaceTextIfAny, resolveWorkspacePath } from "@openshain/core";
 import { csvText } from "@openshain/tools";
 
 /** How much of a change the screen shows before it says the rest is cut. */
@@ -49,9 +48,8 @@ export async function previewCall(
   // The same guard the tools run under: a path outside the workspace, a reserved one or a
   // symlink that leads out is refused here too, so the screen never shows what the call cannot
   // touch. The model chooses this path; the person is about to read what it says.
-  let resolved: string;
   try {
-    resolved = await resolveWorkspacePath(workspaceRoot, path);
+    await resolveWorkspacePath(workspaceRoot, path);
   } catch (err) {
     return [
       {
@@ -60,7 +58,7 @@ export async function previewCall(
       },
     ];
   }
-  const before = await readFile(resolved, "utf8").catch(() => undefined);
+  const before = await readWorkspaceTextIfAny(workspaceRoot, path);
   if (before === undefined) {
     const lines = content.split("\n");
     return cap([

package/src/tui/controller.ts

@@ -1,6 +1,7 @@
 import {
   type ApprovalAnswer,
   type ApprovalChoice,
+  type CompactionOutcome,
   connectInMemory,
   createSession,
   type HeldApproval,
@@ -95,6 +96,48 @@ export interface ControllerOptions {
   providers: RuntimeProviders;
 }
 
+/**
+ * What the screen says when the conversation was summarized. The person cannot read the summary
+ * itself, so the line carries what they told the agent: that is the part they can check.
+ */
+export function compactionLine(outcome: CompactionOutcome): string {
+  if (!outcome.done) {
+    switch (outcome.reason) {
+      case "nothing_to_compact":
+        return "まだ要約するところがありません。";
+      case "no_smaller":
+        return "この会話はこれ以上要約できません。いったん終えて、新しく始めるほうが確かです。";
+      case "empty":
+        return "要約が空だったので、会話はそのままです。";
+      case "secret":
+        return "要約に鍵らしき文字列が入ったので、記録しませんでした。会話はそのままです。";
+      default:
+        return `要約に失敗したので、会話はそのままです。${outcome.detail ?? ""}`.trim();
+    }
+  }
+  const assumed = heading(outcome.summary, "人が伝えた前提");
+  const kept = assumed ? `。人が伝えた前提: ${assumed}` : "";
+  return `会話を要約しました(${outcome.covered} 件を 1 件に)${kept}`;
+}
+
+/** What one heading of a summary says, in one line and at most this long. */
+function heading(summary: string, name: string): string | undefined {
+  const lines = summary.split("\n");
+  const at = lines.findIndex((line) => line.includes(name));
+  if (at < 0) return undefined;
+  const said: string[] = [];
+  for (const line of lines.slice(at + 1)) {
+    const text = line.replace(/^[#\s*-]+/, "").trim();
+    if (text === "") continue;
+    if (/^#/.test(line) || /^\*\*/.test(line)) break;
+    said.push(text);
+    if (said.join("、").length > 120) break;
+  }
+  const all = said.join("、");
+  if (all === "" || all === "なし") return undefined;
+  return all.length > 120 ? `${all.slice(0, 120)}…` : all;
+}
+
 const HELP = [
   "/work list         Work の一覧",
   "/work show <id>    Work の詳細",
@@ -102,6 +145,7 @@ const HELP = [
   "/approvals         承認待ちの一覧",
   "/approve <id>      承認して実行する。/reject <id> [理由] で拒否する",
   "/review <id> approve|reject  資格者の判断を記録する。名前と本文を順に聞く",
+  "/compact           会話を要約して短くする。長い会話は自動でも要約される",
   "/tools             使える Tool",
   "/quit              終わる",
   "↑ ↓                前に送った行を入力欄に呼び戻す。いちばん下は新しい入力",
@@ -417,7 +461,10 @@ export async function createController(options: ControllerOptions): Promise<Cont
     if (name === "help") for (const h of HELP) push("line", h);
     else if (name === "quit" || name === "exit") await close();
     else if (name === "tools") await capture((write) => toolsList({ ...options, write }));
-    else if (name === "work" && sub === "list")
+    else if (name === "compact") {
+      const outcome = await session.compact();
+      push(outcome.done ? "progress" : "notice", compactionLine(outcome));
+    } else if (name === "work" && sub === "list")
       await capture((write) => workList({ workspaceRoot: options.workspaceRoot, write }));
     else if (name === "work" && (sub === "show" || sub === "resume") && !args[1])
       push("notice", `/work ${sub} には Work の id が要ります。/work list で確かめてください。`);
@@ -559,6 +606,9 @@ export async function createController(options: ControllerOptions): Promise<Cont
       await stoppable(async (signal) => {
         try {
           const result = await session.turn(text, { signal });
+          if (result.compacted) {
+            push(result.compacted.done ? "progress" : "notice", compactionLine(result.compacted));
+          }
           // What the work recorded is the agent's own writing, so it stands in when the turn
           // ends with nothing said. Without this the person is left with a work that finished
           // and no answer, which is what a model that skips its summary leaves behind.