Kjell Tore Guttormsen aca38d6558 feat(ultraplan-local): v1.6.0 — /ultraresearch-local deep research command

Add /ultraresearch-local for structured research combining local codebase
analysis with external knowledge via parallel agent swarms. Produces research
briefs with triangulation, confidence ratings, and source quality assessment.

New command: /ultraresearch-local with modes --quick, --local, --external, --fg.
New agents: research-orchestrator (opus), docs-researcher, community-researcher,
security-researcher, contrarian-researcher, gemini-bridge (all sonnet).
New template: research-brief-template.md.

Integration: --research flag in /ultraplan-local accepts pre-built research
briefs (up to 3), enriches the interview and exploration phases. Planning
orchestrator cross-references brief findings during synthesis.

Design principle: Context Engineering — right information to right agent at
right time. Research briefs are structured artifacts in the pipeline:
ultraresearch → brief → ultraplan --research → plan → ultraexecute.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-08 08:58:35 +02:00

3.1 KiB

Raw Blame History

Interaction Awareness — Developer Reference

Claude Code plugin for AI interaction pattern awareness.

Architecture

Four layers, each building on the previous:

Layer 1 (skills/) — SKILL.md behavioral overrides. Always active.
Layer 2 (hooks/scripts/) — Programmatic detection via 4 hook events. Node.js (.mjs), cross-platform. Writes JSONL metadata to ${CLAUDE_PLUGIN_DATA}.
Layer 3 (commands/) — User-triggered reports from Layer 2 data. Opt-in.
Layer 4 (commands/interaction-report.md Step 9) — Contemplative references. Opt-in.

Key files

File	Purpose
`hooks/scripts/lib.mjs`	Shared library: stdin, paths, thresholds, state, cooldowns, layer guards
`hooks/scripts/session-start.mjs`	SessionStart: register session, count daily, night check
`hooks/scripts/prompt-analyzer.mjs`	UserPromptSubmit: pattern flags (NEVER logs prompt text)
`hooks/scripts/tool-tracker.mjs`	PostToolUse: events, edit ratio, burst, alerts
`hooks/scripts/session-end.mjs`	SessionEnd: finalize JSONL, cleanup state
`hooks/hooks.json`	Hook event registration (4 events)
`skills/ai-psychosis/SKILL.md`	Layer 1 behavioral instructions
`commands/interaction-report.md`	Layer 3 slash command: `/interaction-report [weekly\|monthly\|all]`

Legacy bash scripts were removed in v1.0 (available in git history).

Data storage

${CLAUDE_PLUGIN_DATA}/
├── sessions.jsonl       Compact JSONL, one record per session
├── events.jsonl         {ts, session_id, tool_name} per tool call
└── state/
    └── {session_id}.json    Live state during active session

State files are created at SessionStart and deleted at SessionEnd.

Hard constraints

Cross-platform — Node.js only, no bash/jq dependency
Privacy — prompt text NEVER written to disk. Boolean flags only.
Performance — hooks must complete in <100ms
Non-blocking — never exit 2, never require confirmation
No network — everything local
Zero npm dependencies — Node.js stdlib only (fs, path, os)

Layer configuration

Global config at ~/.claude/ai-psychosis.local.md, or per-project override at <project>/.claude/ai-psychosis.local.md:

---
layer2: true   # default on
layer3: false  # default off
layer4: false  # default off
---

requireLayer(N) in lib.mjs exits with {"continue": true} if layer N is disabled.

Testing

Automated test suite using node:test (73 cases, zero npm dependencies):

node --test tests/*.test.mjs

File	Cases	Coverage
`tests/session-start.test.mjs`	4	State init, JSONL, missing sid
`tests/prompt-analyzer.test.mjs`	56	25 patterns × 2 + 6 thresholds
`tests/tool-tracker.test.mjs`	8	Counting, burst, reminders
`tests/session-end.test.mjs`	4	Finalize, duration, flags
`tests/privacy.test.mjs`	1	Canary string never on disk

Conventions

Conventional Commits: type(scope): description
English for all code, comments, and documentation
Norwegian for project-internal communication

3.1 KiB Raw Blame History Unescape Escape