@moreih29/nexus-core 0.13.0 → 0.14.1

package/README.md

@@ -18,7 +18,10 @@
 
 ## Installation
 
+**요구사항: Node.js 22 이상** (`import ... with { type: "json" }` 구문이 Node 22에서 stable입니다.)
+
 ```bash
+node --version   # v22.0.0 이상 확인
 bun add -D @moreih29/nexus-core
 ```
 
@@ -63,6 +66,37 @@ git add . && git commit -m "Initial plugin scaffold"
 
 ---
 
+## Consumer 통합 가이드
+
+### 서브패스 경유 정책
+
+`@moreih29/nexus-core`의 bare import(`import "@moreih29/nexus-core"`)는 의도적으로 비활성화되어 있습니다 (`"."` export = `null`). 모든 기능은 서브패스를 통해 접근해야 합니다.
+
+| 서브패스 | 노출 내용 |
+|---|---|
+| `@moreih29/nexus-core/hooks/opencode-mount` | `mountHooks` 함수 |
+| `@moreih29/nexus-core/hooks/runtime` | 런타임 유틸리티 |
+| `@moreih29/nexus-core/hooks/opencode-manifest` | OpenCode hook JSON manifest |
+
+### OpenCode 플러그인 thin-wrapper 예제
+
+OpenCode 플러그인을 구축하는 가장 간단한 패턴은 다음과 같습니다.
+
+```typescript
+import type { Plugin } from "@opencode-ai/plugin";
+import { mountHooks } from "@moreih29/nexus-core/hooks/opencode-mount";
+import manifest from "@moreih29/nexus-core/hooks/opencode-manifest" with { type: "json" };
+
+export const OpencodeNexus: Plugin = async (ctx) => mountHooks(ctx, manifest);
+```
+
+- `manifest`는 `./hooks/opencode-manifest` 서브패스를 통해 JSON으로 임포트합니다. Node 22의 `import ... with { type: "json" }` 구문이 필요합니다.
+- `mountHooks(ctx, manifest)`는 manifest에 정의된 훅을 OpenCode context에 등록합니다.
+
+전체 하네스별 통합 절차는 [`docs/plugin-guide.md`](./docs/plugin-guide.md)를 참조하세요.
+
+---
+
 ## Consumer 하네스
 
 | 하네스 | 플러그인 repo |

package/dist/assets/hooks/agent-bootstrap/handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookHandler } from "../../../src/hooks/types.js";
+declare const handler: HookHandler;
+export default handler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/assets/hooks/agent-bootstrap/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAoF/D,QAAA,MAAM,OAAO,EAAE,WAgCd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/agent-bootstrap/handler.js

@@ -0,0 +1,100 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+const CORE_INDEX_SIZE_LIMIT = 2 * 1024; // 2KB
+function loadValidRoles(cwd) {
+    const agentsDir = join(cwd, "assets/agents");
+    const roles = [];
+    if (existsSync(agentsDir)) {
+        for (const entry of readdirSync(agentsDir, { withFileTypes: true })) {
+            if (entry.isDirectory())
+                roles.push(entry.name);
+        }
+    }
+    return roles;
+}
+function readFirstLine(path) {
+    try {
+        const content = readFileSync(path, "utf-8");
+        const firstNonEmpty = content.split("\n").find((l) => l.trim().length > 0) ?? "";
+        return firstNonEmpty.replace(/^#+\s*/, "").slice(0, 80);
+    }
+    catch {
+        return "";
+    }
+}
+function buildCoreIndex(cwd) {
+    const entries = [];
+    for (const sub of [".nexus/memory", ".nexus/context"]) {
+        const absDir = join(cwd, sub);
+        if (!existsSync(absDir))
+            continue;
+        for (const f of readdirSync(absDir, { withFileTypes: true })) {
+            if (!f.isFile() || !f.name.endsWith(".md"))
+                continue;
+            const full = join(absDir, f.name);
+            entries.push({
+                path: `${sub}/${f.name}`,
+                mtime: statSync(full).mtimeMs,
+                line: readFirstLine(full),
+            });
+        }
+    }
+    entries.sort((a, b) => b.mtime - a.mtime);
+    const lines = [];
+    let bytes = 0;
+    for (const e of entries) {
+        const formatted = `- ${e.path}: ${e.line}`;
+        if (bytes + formatted.length + 1 > CORE_INDEX_SIZE_LIMIT)
+            break;
+        lines.push(formatted);
+        bytes += formatted.length + 1;
+    }
+    return lines.length > 0
+        ? "Available memory/context:\n" + lines.join("\n")
+        : "";
+}
+function getResumeCount(cwd, sessionId, agentId) {
+    const trackerPath = join(cwd, ".nexus/state", sessionId, "agent-tracker.json");
+    if (!existsSync(trackerPath))
+        return 0;
+    try {
+        const tracker = JSON.parse(readFileSync(trackerPath, "utf-8"));
+        const entry = Array.isArray(tracker)
+            ? tracker.find((e) => e.agent_id === agentId)
+            : null;
+        return entry?.resume_count ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+const handler = async (input) => {
+    if (input.hook_event_name !== "SubagentStart")
+        return;
+    const { cwd, session_id, agent_type, agent_id } = input;
+    // fresh only — skip on resume
+    const resumeCount = getResumeCount(cwd, session_id, agent_id);
+    if (resumeCount > 0)
+        return;
+    // unregistered role: silent skip
+    const validRoles = loadValidRoles(cwd);
+    if (!validRoles.includes(agent_type))
+        return;
+    const parts = [];
+    const coreIndex = buildCoreIndex(cwd);
+    if (coreIndex) {
+        parts.push(`<system-notice>\n${coreIndex}\n</system-notice>`);
+    }
+    const rulePath = join(cwd, ".nexus/rules", `${agent_type}.md`);
+    if (existsSync(rulePath)) {
+        const ruleContent = readFileSync(rulePath, "utf-8").trim();
+        if (ruleContent) {
+            parts.push(`<system-notice>\nCustom rule for ${agent_type}:\n${ruleContent}\n</system-notice>`);
+        }
+    }
+    if (parts.length === 0)
+        return;
+    return { additional_context: parts.join("\n\n") };
+};
+export default handler;
+//# sourceMappingURL=handler.js.map

package/dist/assets/hooks/agent-bootstrap/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"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"}

package/dist/assets/hooks/agent-finalize/handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookHandler } from "../../../src/hooks/types.js";
+declare const handler: HookHandler;
+export default handler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/assets/hooks/agent-finalize/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/agent-finalize/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK/D,QAAA,MAAM,OAAO,EAAE,WAoEd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/agent-finalize/handler.js

@@ -0,0 +1,63 @@
+import { updateJsonFileLocked } from "../../../src/shared/json-store.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const handler = async (input) => {
+    if (input.hook_event_name !== "SubagentStop")
+        return;
+    const { cwd, session_id, agent_type, agent_id } = input;
+    const lastMessage = (input.last_assistant_message ?? "").slice(0, 500);
+    const sessionDir = join(cwd, ".nexus/state", session_id);
+    const trackerPath = join(sessionDir, "agent-tracker.json");
+    const toolLogPath = join(sessionDir, "tool-log.jsonl");
+    const tasksPath = join(sessionDir, "tasks.json");
+    // 1. tracker update + files_touched aggregation (locked)
+    await updateJsonFileLocked(trackerPath, [], (tracker) => {
+        const entry = tracker.find((e) => e["agent_id"] === agent_id);
+        if (!entry)
+            return tracker;
+        entry["status"] = "completed";
+        entry["stopped_at"] = new Date().toISOString();
+        entry["last_message"] = lastMessage;
+        if (existsSync(toolLogPath)) {
+            const files = new Set();
+            const raw = readFileSync(toolLogPath, "utf-8");
+            for (const line of raw.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const log = JSON.parse(line);
+                    if (log["agent_id"] === agent_id && typeof log["file"] === "string") {
+                        files.add(log["file"]);
+                    }
+                }
+                catch {
+                    // skip malformed lines
+                }
+            }
+            entry["files_touched"] = [...files];
+        }
+        return tracker;
+    });
+    // 2. pending tasks alert (owner.role === agent_type)
+    if (!existsSync(tasksPath))
+        return;
+    try {
+        const tasksData = JSON.parse(readFileSync(tasksPath, "utf-8"));
+        const tasks = Array.isArray(tasksData?.["tasks"])
+            ? tasksData["tasks"]
+            : [];
+        const incomplete = tasks.filter((t) => t["owner"]?.["role"] === agent_type &&
+            t["status"] !== "completed");
+        if (incomplete.length === 0)
+            return;
+        const ids = incomplete.map((t) => t["id"]).join(", ");
+        return {
+            additional_context: `<system-notice>\nSubagent "${agent_type}" finished. Tasks still pending with this role: ${ids}. Review status and coordinate remaining subagent delegation.\n</system-notice>`,
+        };
+    }
+    catch {
+        return;
+    }
+};
+export default handler;
+//# sourceMappingURL=handler.js.map

package/dist/assets/hooks/agent-finalize/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/agent-finalize/handler.ts"],"names":[],"mappings":"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"}

package/dist/assets/hooks/post-tool-telemetry/handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookHandler } from "../../../src/hooks/types.js";
+declare const handler: HookHandler;
+export default handler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/assets/hooks/post-tool-telemetry/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/post-tool-telemetry/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAY/D,QAAA,MAAM,OAAO,EAAE,WAkCd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/post-tool-telemetry/handler.js

@@ -0,0 +1,40 @@
+import { appendJsonLine } from "../../../src/shared/json-store.js";
+import { join, resolve, relative } from "node:path";
+const EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "ApplyPatch", "NotebookEdit"]);
+function isWithinMemory(filePath, projectRoot) {
+    const memRoot = resolve(projectRoot, ".nexus/memory");
+    const abs = resolve(filePath);
+    return abs.startsWith(memRoot + "/") || abs === memRoot;
+}
+const handler = async (input) => {
+    if (input.hook_event_name !== "PostToolUse")
+        return;
+    const { cwd, session_id, tool_name, agent_id } = input;
+    const toolInput = (input.tool_input ?? {});
+    // 1. Memory access tracking (Read)
+    if (tool_name === "Read") {
+        const filePath = toolInput.file_path;
+        if (filePath && isWithinMemory(filePath, cwd)) {
+            appendJsonLine(join(cwd, ".nexus/memory-access.jsonl"), {
+                path: relative(cwd, resolve(filePath)),
+                accessed_at: new Date().toISOString(),
+                agent: agent_id ?? null,
+            });
+        }
+    }
+    // 2. Tool-log append (edit tools + agent_id present)
+    if (EDIT_TOOLS.has(tool_name) && agent_id) {
+        const filePath = (toolInput.file_path ?? toolInput.notebook_path);
+        if (filePath) {
+            appendJsonLine(join(cwd, ".nexus/state", session_id, "tool-log.jsonl"), {
+                ts: new Date().toISOString(),
+                agent_id,
+                tool: tool_name,
+                file: relative(cwd, resolve(filePath)),
+                status: "ok",
+            });
+        }
+    }
+};
+export default handler;
+//# sourceMappingURL=handler.js.map

package/dist/assets/hooks/post-tool-telemetry/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/post-tool-telemetry/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;AAEzF,SAAS,cAAc,CAAC,QAAgB,EAAE,WAAmB;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC;AAC1D,CAAC;AAED,MAAM,OAAO,GAAgB,KAAK,EAAE,KAAK,EAAE,EAAE;IAC3C,IAAI,KAAK,CAAC,eAAe,KAAK,aAAa;QAAE,OAAO;IAEpD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;IAEtE,mCAAmC;IACnC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,SAAS,CAAC,SAA+B,CAAC;QAC3D,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YAC9C,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,4BAA4B,CAAC,EAAE;gBACtD,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,KAAK,EAAE,QAAQ,IAAI,IAAI;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,aAAa,CAAuB,CAAC;QACxF,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CACZ,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,CAAC,EACvD;gBACE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,QAAQ;gBACR,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtC,MAAM,EAAE,IAAI;aACb,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/prompt-router/handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookHandler } from "../../../src/hooks/types.js";
+declare const handler: HookHandler;
+export default handler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/assets/hooks/prompt-router/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/prompt-router/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,6BAA6B,CAAC;AAmGhF,QAAA,MAAM,OAAO,EAAE,WA+Jd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/prompt-router/handler.js

@@ -0,0 +1,204 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { expandInvocations, } from "../../../src/shared/invocations.js";
+// Tag priority: specific variants first (m:gc > m, rule:name > rule, plan:auto > plan, init:reset > init)
+const TAG_PATTERNS = [
+    { name: "plan:auto", regex: /\[plan:auto\]/ },
+    { name: "plan", regex: /\[plan\](?!\w)/ },
+    { name: "run", regex: /\[run\](?!\w)/ },
+    { name: "d", regex: /\[d\](?!\w)/ },
+    { name: "m:gc", regex: /\[m:gc\]/ },
+    { name: "m", regex: /\[m\](?!\w)/ },
+    { name: "rule:name", regex: /\[rule:([a-zA-Z0-9_-]+)\]/ },
+    { name: "rule", regex: /\[rule\](?!\w)/ },
+    { name: "sync", regex: /\[sync\](?!\w)/ },
+    { name: "init:reset", regex: /\[init:reset\]/ },
+    { name: "init", regex: /\[init\](?!\w)/ },
+];
+// ---------------------------------------------------------------------------
+// Invocations loader — cached per process
+// ---------------------------------------------------------------------------
+let _invocationsCache = null;
+function loadInvocations() {
+    if (_invocationsCache)
+        return _invocationsCache;
+    const selfDir = new URL(".", import.meta.url).pathname;
+    // Walk up from handler directory to find assets/tools/tool-name-map.yml
+    let dir = selfDir;
+    while (dir !== "/") {
+        const candidate = resolve(dir, "assets/tools/tool-name-map.yml");
+        if (existsSync(candidate)) {
+            const raw = readFileSync(candidate, "utf-8");
+            const parsed = parseYaml(raw);
+            if (!parsed.invocations) {
+                throw new Error("[prompt-router] tool-name-map.yml missing 'invocations' section");
+            }
+            _invocationsCache = parsed.invocations;
+            return _invocationsCache;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`[prompt-router] Cannot locate assets/tools/tool-name-map.yml from ${selfDir}`);
+}
+// ---------------------------------------------------------------------------
+// Harness resolution
+// ---------------------------------------------------------------------------
+function resolveHarness() {
+    const h = process.env["NEXUS_HARNESS"];
+    if (h === "claude" || h === "opencode" || h === "codex")
+        return h;
+    if (h) {
+        process.stderr.write(`[prompt-router] Unknown NEXUS_HARNESS="${h}", falling back to "claude"\n`);
+    }
+    return "claude";
+}
+// ---------------------------------------------------------------------------
+// Invocation expansion helper
+// ---------------------------------------------------------------------------
+function expand(template, harness) {
+    return expandInvocations(template, harness, loadInvocations());
+}
+// ---------------------------------------------------------------------------
+// Rule target loader
+// ---------------------------------------------------------------------------
+function loadValidRuleTargets(cwd) {
+    const targets = [];
+    for (const dir of ["assets/agents", "assets/skills"]) {
+        const absDir = join(cwd, dir);
+        if (!existsSync(absDir))
+            continue;
+        for (const entry of readdirSync(absDir, { withFileTypes: true })) {
+            if (entry.isDirectory())
+                targets.push(entry.name);
+        }
+    }
+    return targets;
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+const handler = async (input) => {
+    if (input.hook_event_name !== "UserPromptSubmit")
+        return;
+    const prompt = input.prompt;
+    const detected = [];
+    // Detect all tags — use seen Set keyed on base tag name to prevent duplicates
+    // (e.g. plan:auto and plan share base "plan"; whichever appears first wins)
+    const seen = new Set();
+    for (const { name, regex } of TAG_PATTERNS) {
+        const m = regex.exec(prompt);
+        if (!m)
+            continue;
+        const base = name.split(":")[0];
+        if (seen.has(base))
+            continue;
+        seen.add(base);
+        detected.push({ name, arg: m[1] });
+    }
+    const sessionDir = join(input.cwd, ".nexus/state", input.session_id);
+    const planPath = join(sessionDir, "plan.json");
+    const tasksPath = join(sessionDir, "tasks.json");
+    const hasPlan = existsSync(planPath);
+    const hasTasks = existsSync(tasksPath);
+    const harness = resolveHarness();
+    const notices = [];
+    let decision;
+    let block_reason;
+    for (const tag of detected) {
+        switch (tag.name) {
+            case "plan":
+                notices.push(`<system-notice>[plan] tag detected. ${expand('{{skill_activation skill="nx-plan"}}', harness)} for structured planning.</system-notice>`);
+                break;
+            case "plan:auto":
+                notices.push(`<system-notice>[plan:auto] tag detected. ${expand('{{skill_activation skill="nx-plan" mode="auto"}}', harness)} for structured planning.</system-notice>`);
+                break;
+            case "run":
+                if (!hasTasks) {
+                    notices.push(`<system-notice>[run] tag detected but no tasks.json. ${expand('{{skill_activation skill="nx-plan"}}', harness)} with args "auto" first to generate tasks, then run.</system-notice>`);
+                }
+                else {
+                    notices.push(`<system-notice>[run] tag detected. ${expand('{{skill_activation skill="nx-run"}}', harness)} to execute tasks.</system-notice>`);
+                }
+                break;
+            case "d":
+                if (!hasPlan) {
+                    decision = "block";
+                    block_reason =
+                        `[d] tag requires an active plan session. ${expand('{{skill_activation skill="nx-plan"}}', harness)} first.`;
+                }
+                else {
+                    notices.push(`<system-notice>[d] tag detected. Record decision via \`nx_plan_decide(issue_id, summary)\` MCP tool.</system-notice>`);
+                }
+                break;
+            case "m":
+                notices.push(`<system-notice>[m] tag detected. Save a memory note to \`.nexus/memory/<prefix>-<name>.md\`. Prefix: empirical-, external-, or pattern- (see architecture.md §2-1).</system-notice>`);
+                break;
+            case "m:gc":
+                notices.push(`<system-notice>[m:gc] tag detected. Review \`.nexus/memory/\` for stale or duplicate entries and consolidate.</system-notice>`);
+                break;
+            case "rule": {
+                const valid = loadValidRuleTargets(input.cwd);
+                notices.push(`<system-notice>[rule] tag detected. Determine target from intent. Valid targets: ${valid.join(", ")}. Update \`.nexus/rules/<target>.md\`.</system-notice>`);
+                break;
+            }
+            case "rule:name": {
+                const valid = loadValidRuleTargets(input.cwd);
+                const name = tag.arg ?? "";
+                if (!valid.includes(name)) {
+                    decision = "block";
+                    block_reason = `[rule:${name}] invalid — must be one of: ${valid.join(", ")}`;
+                }
+                else {
+                    notices.push(`<system-notice>[rule:${name}] tag detected. Update \`.nexus/rules/${name}.md\` with user's directive.</system-notice>`);
+                }
+                break;
+            }
+            case "sync":
+                notices.push(`<system-notice>[sync] tag detected. ${expand('{{skill_activation skill="nx-sync"}}', harness)} to synchronize \`.nexus/context/\`.</system-notice>`);
+                break;
+            case "init":
+                notices.push(`<system-notice>[init] tag detected. ${expand('{{skill_activation skill="nx-init"}}', harness)} for project onboarding.</system-notice>`);
+                break;
+            case "init:reset":
+                notices.push(`<system-notice>[init:reset] tag detected. ${expand('{{skill_activation skill="nx-init" mode="reset"}}', harness)} for full re-initialization.</system-notice>`);
+                break;
+        }
+    }
+    // No tags detected + active state → emit state notice
+    if (detected.length === 0) {
+        if (hasPlan) {
+            try {
+                const plan = JSON.parse(readFileSync(planPath, "utf-8"));
+                const pending = plan.issues?.filter((i) => i.status === "pending").length ?? 0;
+                notices.push(`<system-notice>Active plan session: "${plan.topic ?? "(unknown)"}", ${pending} issues pending.</system-notice>`);
+            }
+            catch {
+                // Malformed plan.json — skip notice
+            }
+        }
+        else if (hasTasks) {
+            try {
+                const tasks = JSON.parse(readFileSync(tasksPath, "utf-8"));
+                const pending = tasks.tasks?.filter((t) => t.status !== "completed").length ?? 0;
+                if (pending > 0) {
+                    notices.push(`<system-notice>Active run session: ${pending} tasks remaining in tasks.json.</system-notice>`);
+                }
+            }
+            catch {
+                // Malformed tasks.json — skip notice
+            }
+        }
+    }
+    if (decision === "block") {
+        return { decision, block_reason };
+    }
+    if (notices.length === 0)
+        return;
+    return { additional_context: notices.join("\n\n") };
+};
+export default handler;
+//# sourceMappingURL=handler.js.map

package/dist/assets/hooks/prompt-router/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/prompt-router/handler.ts"],"names":[],"mappings":"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"}

package/dist/assets/hooks/session-init/handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookHandler } from "../../../src/hooks/types.js";
+declare const handler: HookHandler;
+export default handler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/assets/hooks/session-init/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D,QAAA,MAAM,OAAO,EAAE,WAuBd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/session-init/handler.js

@@ -0,0 +1,23 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, basename } from "node:path";
+const handler = async (input) => {
+    if (input.hook_event_name !== "SessionStart")
+        return;
+    // Sanitize session_id to prevent path traversal
+    const safeSid = basename(input.session_id);
+    if (!safeSid || safeSid.startsWith(".") || safeSid.includes("/")) {
+        process.stderr.write(`[session-init] invalid session_id: ${input.session_id}\n`);
+        return;
+    }
+    const sessionDir = join(input.cwd, ".nexus/state", safeSid);
+    // Ensure directory exists (idempotent)
+    mkdirSync(sessionDir, { recursive: true });
+    // Initialize per-session state files — overwrite unconditionally (resume is intentional)
+    writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
+    writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
+    // plan.json and tasks.json are MCP responsibility — not touched here
+    // memory-access.jsonl is project-level — not touched here
+    // No additional_context returned (decided: no context injection at session start)
+};
+export default handler;
+//# sourceMappingURL=handler.js.map

package/dist/assets/hooks/session-init/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,OAAO,GAAgB,KAAK,EAAE,KAAK,EAAE,EAAE;IAC3C,IAAI,KAAK,CAAC,eAAe,KAAK,cAAc;QAAE,OAAO;IAErD,gDAAgD;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE5D,uCAAuC;IACvC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,yFAAyF;IACzF,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD,qEAAqE;IACrE,0DAA0D;IAE1D,kFAAkF;AACpF,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC"}