@event4u/agent-config 7.4.0 → 8.0.0

package/src/config/agents-paths.yml

@@ -0,0 +1,254 @@
+# Ignore/track classification manifest for agent-config managed paths.
+#
+# Consumed by:
+#   - scripts/generate_gitignore_block.ts  → src/config/gitignore-block.txt
+#   - scripts/check_gitignore_freshness.ts → CI drift gate (Phase 3.4)
+#   - scripts/lint_agents_layout.ts        → cross-checks policy labels
+#
+# Fields:
+#   path     - the ignore pattern (gitignore syntax)
+#   scope    - package (source repo only) | consumer | both
+#   policy   - tracked | tracked-generated | ignored | carve-out | legacy
+#   writer   - the script / skill / human that creates this path (for audit)
+#   rationale - one-line justification
+#   legacy   - true: add to LEGACY_PATTERNS in sync_gitignore.ts for cleanup
+#   comment  - optional comment block to emit above the pattern in the gitignore
+
+# ---------------------------------------------------------------------------
+# Settings files
+# ---------------------------------------------------------------------------
+
+- path: .agent-settings.yml
+  scope: both
+  policy: ignored
+  writer: installer (scripts/install.py)
+  rationale: Per-user active settings; contains local-path secrets
+
+- path: .agent-settings
+  scope: both
+  policy: ignored
+  writer: installer (legacy flat format, pre-YAML migration)
+  rationale: Legacy flat key=value settings; migrated on first wizard run
+  legacy: true
+
+- path: .agent-settings.backup.key-value
+  scope: both
+  policy: ignored
+  writer: installer (migration backup)
+  rationale: One-shot backup during settings migration; safe to delete after
+  legacy: true
+
+- path: .agent-settings.local.yml
+  scope: both
+  policy: ignored
+  writer: developer (manual)
+  rationale: Machine-local overrides that must never be shared
+
+# ---------------------------------------------------------------------------
+# User persona + observation buffer
+# ---------------------------------------------------------------------------
+
+- path: .agent-user.md
+  scope: both
+  policy: ignored
+  writer: /agents:user:init skill
+  rationale: Personal user identity; local-only by default (shared opt-in deferred)
+  comment: |
+    # Agent config — user-persona file (.agent-user.md, written by /agents user init)
+    # Contains who the user is and how they want to be addressed. Local-only by
+    # default; commit explicitly only via the deferred --shared opt-in.
+    # See docs/contracts/agent-user-schema.md.
+
+- path: .agent-user.md.bak
+  scope: both
+  policy: ignored
+  writer: installer (backup)
+  rationale: Safety backup during persona migration
+
+- path: .agent-user.observations.jsonl
+  scope: both
+  policy: ignored
+  writer: /agents:user:review skill
+  rationale: Append-only raw observation buffer; never shared
+  comment: |
+    # Agent config — user-persona observation buffer (append-only JSONL,
+    # never shared). Feeds /agents user review / accept only.
+
+# ---------------------------------------------------------------------------
+# Memory intake (gitignored; curated YAML subsets are committed)
+# ---------------------------------------------------------------------------
+
+- path: /agents/memory/intake/
+  scope: both
+  policy: ignored
+  writer: /memory:mine-session skill
+  rationale: Raw low-confidence intake; promotion to committed YAML is human-gated
+  comment: |
+    # Agent config — raw memory intake (append-only, low-confidence, agent-written
+    # by /memory mine-session). Local scratch only — commit ONLY the curated YAML
+    # promoted out of it (agents/memory/<type>/*.yml stays tracked).
+
+- path: /agents/memory/ephemeral/
+  scope: both
+  policy: ignored
+  writer: Evidence v2 project-intelligence pipeline (contexts/execution/project-intelligence.md)
+  rationale: Per-session trial-and-error observations; TTL managed; never promoted
+
+# ---------------------------------------------------------------------------
+# Knowledge intake (gitignored; committed pages live in agents/knowledge/)
+# ---------------------------------------------------------------------------
+
+- path: /agents/knowledge/intake/
+  scope: both
+  policy: ignored
+  writer: /team-knowledge:consolidate skill
+  rationale: Append-only JSONL events; consolidated into committed pages on human review
+  comment: |
+    # Agent config — typed knowledge-observation events (append-only JSONL).
+    # Consolidated via /team-knowledge consolidate into committed pages under
+    # agents/knowledge/{sessions,concepts,procedures,decisions}/.
+
+- path: /agents/.bootstrap-staging/
+  scope: both
+  policy: ignored
+  writer: /team-knowledge:bootstrap skill
+  rationale: Deterministic template pages; review-then-commit flow (nothing here is the artifact)
+
+# ---------------------------------------------------------------------------
+# Ghostwriter profiles
+# ---------------------------------------------------------------------------
+
+- path: /agents/ghostwriter/*.md
+  scope: both
+  policy: ignored
+  writer: /ghostwriter:fetch skill
+  rationale: Real-person voice profiles; local-only by default; shared opt-in deferred
+  comment: |
+    # Agent config — ghostwriter profiles (real-person public-figure voices).
+    # Local-only by default; commit explicitly only via the deferred --shared opt-in.
+    # See docs/contracts/ghostwriter-schema.md.
+
+- path: "!/agents/ghostwriter/README.md"
+  scope: both
+  policy: carve-out
+  writer: maintainer
+  rationale: README is tracked and ships with the package
+
+- path: /agents/ghostwriter/*.md.bak
+  scope: both
+  policy: ignored
+  writer: /ghostwriter:fetch skill (backup)
+  rationale: Safety backup during profile updates
+
+# ---------------------------------------------------------------------------
+# Chat history (legacy path; current installs use agents/runtime/)
+# ---------------------------------------------------------------------------
+
+- path: /agents/.agent-chat-history
+  scope: both
+  policy: ignored
+  writer: scripts/chat_history.py (legacy flat path)
+  rationale: Legacy location; current installs write to agents/runtime/.agent-chat-history
+  legacy: true
+
+- path: /agents/.agent-chat-history.bak
+  scope: both
+  policy: ignored
+  writer: scripts/chat_history.py
+  rationale: Crash-recovery backup; local-only
+  legacy: true
+
+- path: /agents/.agent-chat-history.*.bak
+  scope: both
+  policy: ignored
+  writer: scripts/chat_history.py
+  rationale: Timestamped backup variants; local-only
+  legacy: true
+
+# ---------------------------------------------------------------------------
+# Telemetry
+# ---------------------------------------------------------------------------
+
+- path: .agent-engagement.jsonl
+  scope: both
+  policy: ignored
+  writer: ./agent-config telemetry:record
+  rationale: Artefact engagement telemetry; default-off; maintainer-only
+  comment: |
+    # Agent config — artefact engagement telemetry (default-off, maintainer-only, never commit)
+
+- path: .agent-engagement.jsonl.bak
+  scope: both
+  policy: ignored
+  writer: ./agent-config telemetry:record (backup)
+  rationale: Telemetry log backup
+
+# ---------------------------------------------------------------------------
+# Volatile runtime (entire tree)
+# ---------------------------------------------------------------------------
+
+- path: /agents/runtime/
+  scope: both
+  policy: ignored
+  writer: multiple scripts (council, chat-history, metrics, hooks, mcp-telemetry, etc.)
+  rationale: All volatile session/TTL artefacts; single catch-all per the Volatile Runtime policy
+  comment: |
+    # Agent config — volatile runtime artefacts (machine-generated,
+    # regenerated on demand, never committed). Single catch-all per the
+    # Volatile Runtime policy: everything under agents/runtime/ is
+    # local-only — price cache, council questions/responses/sessions,
+    # council events log, Tier 1 hook runtime state, chat-history, budget
+    # history, density / frugality / logs / mcp-telemetry / tmp scratch.
+    # Durable evidence cited from docs / ADRs lives in agents/evidence/;
+    # decision records in agents/decisions/.
+
+# ---------------------------------------------------------------------------
+# Hook + wizard runtime state
+# ---------------------------------------------------------------------------
+
+- path: /agents/state/
+  scope: both
+  policy: ignored
+  writer: hooks (context_hygiene_hook.py, etc.) + GUI wizard
+  rationale: Per-rule hook state and wizard resume snapshot; local-only per Volatile Runtime policy
+  comment: |
+    # Agent config — Tier 1 hook + wizard runtime state (machine-generated,
+    # regenerated on demand, never committed). Holds the dispatcher lock,
+    # per-rule hook state, and the GUI wizard resume snapshot.
+
+# ---------------------------------------------------------------------------
+# User inbox (agents/tmp) and processed archive (agents/tmp.old)
+# ---------------------------------------------------------------------------
+
+- path: /agents/tmp/
+  scope: both
+  policy: ignored
+  writer: user (human)
+  rationale: |
+    User inbox — user drops notes/todos; agent reads + moves to tmp.old/ on
+    consumption. Agent scratch never goes here. See docs/contracts/agents-layout.md § User Inbox Workflow.
+  comment: |
+    # Agent config — user inbox (free-form notes/todos for the agent to consume).
+    # User-owned; never auto-swept by the janitor.
+    # Agent scratch → agents/runtime/tmp/ (NOT this dir).
+    # See docs/contracts/agents-layout.md § User Inbox Workflow.
+
+- path: /agents/tmp.old/
+  scope: both
+  policy: ignored
+  writer: agent (moves consumed tmp/ files here)
+  rationale: Processed inbox archive; TTL 30 days (janitor sweeps); never contains agent scratch
+  comment: |
+    # Agent config — processed inbox archive. The agent moves consumed tmp/ files
+    # here after processing (roadmap created, note promoted, etc.).
+    # Janitor TTL: 30 days. See docs/contracts/agents-layout.md § User Inbox Workflow.
+
+# ---------------------------------------------------------------------------
+# Wizard partial state
+# ---------------------------------------------------------------------------
+
+- path: /.agent-config/wizard-state.json
+  scope: both
+  policy: ignored
+  writer: Fastify wizard server (POST /api/v1/wizard/state)
+  rationale: Step-transition crash-recovery; deleted on wizard finish; local-only

package/src/config/budgets.yml

@@ -0,0 +1,16 @@
+# Consumer-tool load-budget caps for this package's projections.
+#
+# Single source of truth for the budget gates — scripts read these values
+# instead of hard-coding them (measure_augment_budget, and any future
+# per-tool budget meter).
+
+augment_workspace_guidelines:
+  # Verified platform maximum: 99,024 chars (re-measured 2026-07; the old
+  # 49,512 ceiling from the 2026-05-08 baseline is obsolete). We deliberately
+  # gate against a LOWER internal cap to keep headroom for consumer-side
+  # additions and future rules — raise total_cap_chars only as needed, and
+  # NEVER above platform_max_chars.
+  platform_max_chars: 99024
+  total_cap_chars: 64000
+  warn_threshold: 0.85
+  fail_threshold: 0.95

package/src/config/discovery/packs.yml

@@ -304,6 +304,7 @@
   label: Meta
   description: Artefacts that maintain this package (agent-config itself).
   workspaces: [agent-config-maintainer]
+  requires: [engineering-base]  # reasoning-orchestrator (meta) invokes adversarial-review (engineering-base)
   trust_level_default: core
   domain: meta
   size_class: core

package/src/config/discovery/unassigned-artefacts.yml

@@ -36,6 +36,8 @@
   reason: scaffold for project deployment-order context
 - path: src/agent-src/templates/contexts/knowledge-card.md
   reason: fill-in skeleton for committed knowledge cards (evidence-first structure discovery / ADR-098); frontmatter is the example shape a filled card carries, not a runtime artefact
+- path: src/agent-src/templates/contexts/knowledge-pages.md
+  reason: convention doc for the typed agents/knowledge/ page directories (road-to-knowledge-system); documents the optional page frontmatter shape, carries none itself
 - path: src/agent-src/templates/contexts/lesson-card.md
   reason: fill-in skeleton for Class-C learned lessons (Evidence v2 project-intelligence); frontmatter is the example shape a filled lesson carries, not a runtime artefact
 - path: .agent-src.uncondensed/templates/contexts/observability.md

package/src/config/gitignore-block.txt

@@ -31,6 +31,7 @@
 
 # Agent config — personal settings (written by the installer)
 .agent-settings.yml
+.agent-settings.local.yml
 .agent-settings
 .agent-settings.backup.key-value
 
@@ -51,6 +52,19 @@
 # repo free of unbounded raw signals. See road-to-memory-pipeline-consolidation.
 /agents/memory/intake/
 
+# Agent config — typed knowledge-observation events (append-only JSONL,
+# convention_detected / mistake_made / api_shape_learned / context_stale).
+# Local scratch only, consolidated via /team-knowledge consolidate into the
+# committed pages under agents/knowledge/{sessions,concepts,procedures,decisions}/.
+# See road-to-knowledge-system Phase 5.
+/agents/knowledge/intake/
+
+# Agent config — project-bootstrap staging (deterministic template pages from
+# /team-knowledge bootstrap). Review-then-commit: pages move into
+# agents/knowledge/ only after human review; nothing here is ever the
+# committed artifact. See road-to-knowledge-system Phase 6.
+/agents/.bootstrap-staging/
+
 # Agent config — Evidence v2 ephemeral project-intelligence tier. Auto-captured
 # trial-and-error / transient / task-local observations, retained N days, NEVER
 # promoted to committed context (distinct from intake, which holds promotion
@@ -95,6 +109,17 @@
 # Local-only per the Volatile Runtime policy.
 /agents/state/
 
+# Agent config — user inbox (free-form notes/todos for the agent to consume).
+# User-owned; never auto-swept by the janitor.
+# Agent scratch → agents/runtime/tmp/ (NOT this dir).
+# See docs/contracts/agents-layout.md § User Inbox Workflow.
+/agents/tmp/
+
+# Agent config — processed inbox archive. The agent moves consumed tmp/ files
+# here after processing (roadmap created, note promoted, etc.).
+# Janitor TTL: 30 days. See docs/contracts/agents-layout.md § User Inbox Workflow.
+/agents/tmp.old/
+
 # Agent config — unified-setup wizard partial state (Roadmap R2 Phase 1).
 # Written by POST /api/v1/wizard/state between step transitions, deleted
 # on POST /api/v1/wizard/finish. Local-only crash-recovery aid.

package/src/config/host-capabilities.yml

@@ -0,0 +1,31 @@
+# Host-capability facts for `discipline_profile: auto` resolution.
+#
+# EVIDENCE-GATED NULL-LIFT DISABLE-LIST — not a model taxonomy.
+# Council lock (claude-sonnet-4-5 + gpt-4o, 2026-07-07, recorded in
+# agents/settings/contexts/weak-host-lift-tiering-verdict.md): entries here
+# name ONLY host models with a MEASURED null discipline lift (the package's
+# discipline tier is redundant on them — they sit at the discipline ceiling).
+# Speculative strong/weak classifications of unmeasured models (per vendor,
+# per family, per glob) are FORBIDDEN: they rot at model-release cadence and
+# encode certainty no measurement backs.
+#
+# Entry contract — every entry carries either:
+#   - measured: <report date · pinned report · N pairs>   (CLAIMS-grade), or
+#   - extrapolated: true + rationale                       (explicit maintainer
+#     judgement, labeled as such — e.g. a strictly-stronger sibling of a
+#     measured-null model). Never an unlabeled assumption.
+#
+# Matching: exact model-id prefix match against the session's model id
+# (vendor-neutral — Claude, GPT, Gemini, open-source ids all welcome once
+# measured). Unknown / unmatched models resolve per `unknown_default`.
+#
+# Fail-safe direction: `unknown_default: lift_enabled` means a new or
+# unmeasured model gets the `essential` discipline tier — it costs ~3x tokens
+# on a host that turns out strong, but never silently drops the measured
+# lift on a weak one. The list only ever GROWS by measurement.
+
+lift_disabled_models:
+  - id: claude-sonnet-4-6
+    measured: "2026-07-05 · internal/bench/reports/ab-v2/2026-07-05T07-00-31Z-ab-v2-paired.json · n=84 pairs, full 30-task corpus, discipline Δ=+0.000 (p=1.0)"
+
+unknown_default: lift_enabled

package/src/config/profiles/balanced.ini

@@ -9,6 +9,10 @@
 
 rule_loading_tier=balanced
 
+; Successor knob (ADR-110) — value preserves this preset's prior behaviour
+; via the legacy mapping (minimal->off, balanced->essential, full->full).
+discipline_profile=essential
+
 ; Chat history (crash recovery) — balanced = phase-level traceability
 chat_history_frequency=per_phase
 chat_history_max_size_kb=256

package/src/config/profiles/full.ini

@@ -9,6 +9,10 @@
 
 rule_loading_tier=full
 
+; Successor knob (ADR-110) — value preserves this preset's prior behaviour
+; via the legacy mapping (minimal->off, balanced->essential, full->full).
+discipline_profile=full
+
 ; Chat history (crash recovery) — full = tool-level traceability + summarize on overflow
 chat_history_frequency=per_tool
 chat_history_max_size_kb=512

package/src/config/profiles/minimal.ini

@@ -9,6 +9,10 @@
 
 rule_loading_tier=minimal
 
+; Successor knob (ADR-110) — value preserves this preset's prior behaviour
+; via the legacy mapping (minimal->off, balanced->essential, full->full).
+discipline_profile=off
+
 ; Chat history (crash recovery) — minimal = lightest footprint
 chat_history_frequency=per_turn
 chat_history_max_size_kb=128