u-foo 1.0.3 → 1.0.6

package/modules/bus/scripts/bus-listen.sh

@@ -1,117 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# bus-listen.sh
-# Foreground listener that prints incoming messages.
-#
-# Usage:
-#   bash bus-listen.sh <subscriber> [options]
-#
-# Options:
-#   --from-beginning  Print existing queued messages first
-#   --reset           Truncate pending queue before listening
-#   --auto-join       Auto-join bus to get subscriber ID
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
-BUS_DIR=".ufoo/bus"
-FROM_BEGINNING=0
-RESET=0
-AUTO_JOIN=0
-
-SUBSCRIBER="${1:-}"
-shift || true
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --from-beginning)
-      FROM_BEGINNING=1
-      shift
-      ;;
-    --reset)
-      RESET=1
-      shift
-      ;;
-    --auto-join)
-      AUTO_JOIN=1
-      shift
-      ;;
-    *)
-      shift
-      ;;
-  esac
-done
-
-# Auto-join if requested
-if [[ "$AUTO_JOIN" == "1" ]] && [[ -z "$SUBSCRIBER" ]]; then
-  SUBSCRIBER="$(ufoo bus join 2>/dev/null | tail -1)"
-  echo "[listen] Auto-joined as: $SUBSCRIBER"
-fi
-
-if [[ -z "$SUBSCRIBER" ]]; then
-  echo "Usage: bus-listen.sh <subscriber> [options]" >&2
-  echo "  or:  bus-listen.sh --auto-join" >&2
-  exit 1
-fi
-
-# Sanitize subscriber for filename
-SAFE_SUB="${SUBSCRIBER//:/_}"
-QUEUE_FILE="$BUS_DIR/queues/${SAFE_SUB}/pending.jsonl"
-QUEUE_DIR="$BUS_DIR/queues/${SAFE_SUB}"
-
-mkdir -p "$QUEUE_DIR"
-touch "$QUEUE_FILE"
-
-# Reset queue if requested
-if [[ "$RESET" == "1" ]]; then
-  echo "[listen] Resetting queue..."
-  : > "$QUEUE_FILE"
-fi
-
-# Print existing messages if requested
-if [[ "$FROM_BEGINNING" == "1" ]] && [[ -s "$QUEUE_FILE" ]]; then
-  echo "[listen] Existing messages:"
-  echo "---"
-  while IFS= read -r line; do
-    # Parse JSON and extract message
-    msg="$(echo "$line" | jq -r '.data.message // .data // .' 2>/dev/null || echo "$line")"
-    from="$(echo "$line" | jq -r '.publisher // "unknown"' 2>/dev/null || echo "unknown")"
-    ts="$(echo "$line" | jq -r '.ts // ""' 2>/dev/null || echo "")"
-    short_ts="${ts:11:8}"  # Extract HH:MM:SS
-    echo "[$short_ts] <$from> $msg"
-  done < "$QUEUE_FILE"
-  echo "---"
-fi
-
-echo "[listen] Listening for new messages... (Ctrl+C to stop)"
-
-# Track last line count
-LAST_LINES=0
-if [[ -s "$QUEUE_FILE" ]]; then
-  LAST_LINES="$(wc -l < "$QUEUE_FILE" | tr -d ' ')"
-fi
-
-while true; do
-  if [[ -f "$QUEUE_FILE" ]]; then
-    CURRENT_LINES="$(wc -l < "$QUEUE_FILE" | tr -d ' ')"
-
-    if [[ "$CURRENT_LINES" -gt "$LAST_LINES" ]]; then
-      # Read new lines
-      tail -n "+$((LAST_LINES + 1))" "$QUEUE_FILE" | while IFS= read -r line; do
-        msg="$(echo "$line" | jq -r '.data.message // .data // .' 2>/dev/null || echo "$line")"
-        from="$(echo "$line" | jq -r '.publisher // "unknown"' 2>/dev/null || echo "unknown")"
-        ts="$(echo "$line" | jq -r '.ts // ""' 2>/dev/null || echo "")"
-        short_ts="${ts:11:8}"
-
-        # Bell notification
-        printf '\a'
-
-        echo "[$short_ts] <$from> $msg"
-      done
-
-      LAST_LINES="$CURRENT_LINES"
-    fi
-  fi
-
-  sleep 1
-done

package/modules/context/ASSUMPTIONS.md

@@ -1,7 +0,0 @@
-# Assumptions
-
-- Users work with multiple AI tools
-- AI agents can read markdown files
-- AI agents respect explicit file instructions
-- Written context survives session boundaries
-- Less structure is better than over-engineering

package/modules/context/CONSTRAINTS.md

@@ -1,7 +0,0 @@
-# Constraints
-
-- Model-agnostic (no Claude/GPT-specific instructions)
-- Project-agnostic (no specific tech stack assumptions)
-- Files are authoritative, not conversations
-- Decisions are append-only
-- All rules must be enforceable by file inspection

package/modules/context/CONTEXT-STRUCTURE.md

@@ -1,49 +0,0 @@
-# Context Structure
-
-## Global (read-only)
-
-```
-~/.ufoo/
-└── modules/
-    └── context/     # installed context module
-```
-
-- **Read-only**
-- Template source for init
-- No decisions, no assumptions
-- Law, not truth
-
-## Project-local (writable)
-
-```
-<project>/
-└── .context/
-    ├── README.md
-    ├── SYSTEM.md
-    ├── CONSTRAINTS.md
-    ├── ASSUMPTIONS.md
-    ├── TERMINOLOGY.md
-    └── DECISIONS/
-```
-
-- **In the repo** — can diff, can review
-- This is where truth lives
-- Must be versionable
-
-## Required files (project)
-
-| File | Purpose |
-|------|---------|
-| README.md | Entry point; how to use this context |
-| SYSTEM.md | Project architecture and purpose |
-| CONSTRAINTS.md | Non-negotiable rules |
-| ASSUMPTIONS.md | Current assumptions (update when changed) |
-| TERMINOLOGY.md | Shared vocabulary |
-| DECISIONS/ | Append-only decision log |
-
-## Red line
-
-**Never write decisions or assumptions to global.**
-
-Global = law.
-Project = truth.

package/modules/context/DECISION-PROTOCOL.md

@@ -1,62 +0,0 @@
-# Decision Protocol
-
-## What is a Decision?
-
-A decision is any new or changed “shared truth” that affects future work, including:
-- Architecture
-- Semantics
-- Roles or responsibilities
-- UI meaning or behavior
-- Naming or structure
-- Installation / distribution / tooling workflows
-- Trade-offs and “we chose X over Y”
-
-## Triage (Must / Ask / Skip)
-
-### Must record (no confirmation needed)
-
-Write a decision **before replying** when you do any of the following:
-
-- Provide an evaluation / analysis / recommendation that could steer future work
-- Propose an improvement plan or a set of next steps
-- Introduce or change any rule/constraint/process
-- Choose a default (e.g. install method, folder structure, version pinning policy)
-- Decide between alternatives (trade-off)
-
-### Ask first (medium importance)
-
-If you’re unsure whether the recommendation should become shared truth, ask:
-
-> “Should I record a decision for X?”
-
-Examples:
-- Optional refactors or style preferences
-- Suggestions that depend on missing info (URL, constraints, team preference)
-- Reversible tweaks that may not be adopted
-
-### Skip (not worth a decision)
-
-Do **not** write a decision for:
-
-- One-off clarifications or Q&A that doesn’t change future behavior
-- Trivial edits (formatting, typos) with no semantic impact
-- Ephemeral runtime details (logs, transient errors) unless they affect policy
-
-## Where Decisions Live
-
-- **Never** write decisions to global `~/.context/` (global = law).
-- Always write decisions to the project-local log:
-  - `<project>/.context/DECISIONS/`
-  - For this repo, that is: `.context/DECISIONS/`
-
-## Rules
-
-- Decisions are append-only.
-- Do not rewrite history.
-- AI agents are allowed to write decisions.
-
-## Minimum Content
-
-- Context: why this matters now
-- Decision: what is now considered true
-- Implications: what must follow from this

package/modules/context/HANDOFF.md

@@ -1,33 +0,0 @@
-# AI Handoff Protocol
-
-## When taking over work
-
-1. Read this repository (global protocol).
-2. Read the project-local `.context/`.
-3. Check for open decisions: `bash scripts/context-decisions.sh -l`
-
-## Processing open decisions
-
-Open decisions are messages from other agents. You MUST:
-
-1. **Read** — Read the full content, not just the title.
-2. **Understand** — Sync their decisions to your understanding.
-3. **Execute** — If action is required, do it first.
-4. **Verify** — Confirm the action succeeded.
-5. **Resolve** — Only then mark as resolved.
-
-```yaml
----
-status: resolved
-resolved_by: <your-agent-name>
-resolved_at: <date>
----
-```
-
-**NEVER resolve blindly.** This defeats the purpose of multi-agent collaboration.
-
-## Before finishing work
-
-- Declare whether any new decisions were introduced.
-- Ensure all decisions are written down.
-- Leave the project ready for the next agent.

package/modules/context/RULES.md

@@ -1,15 +0,0 @@
-# Collaboration Rules
-
-## Core rules
-
-- Always read this repository before coding.
-- Do not rely on model-internal memory.
-- All shared understanding must exist as files.
-- Decisions override comments and discussions.
-- When unsure, write a decision.
-
-## Decision handling
-
-- Open decisions are unprocessed messages from other agents.
-- You must read, understand, and act before resolving.
-- Never resolve without reading the full content.

package/modules/context/SKILLS/README.md

@@ -1,14 +0,0 @@
-# Skills
-
-Protocol-level skills that enforce context rules.
-
-- NOT memory systems
-- Do NOT store project knowledge
-- Only bootstrap and validate protocol compliance
-
-Available:
-- `uctx` — quick context check (list decisions, show latest, report status)
-
-Helpers:
-- `bash scripts/skills.sh list`
-- `bash scripts/skills.sh install <name|all> --codex|--agents|--target <dir>`

package/modules/context/SYSTEM.md

@@ -1,18 +0,0 @@
-# AI System Contract
-
-This repository defines the canonical collaboration context
-for all AI agents working on a codebase.
-
-## Purpose
-
-Solve one core problem with AI coding agents:
-
-1. **Memory sync across agents** — Multiple AI tools (Claude Code, Codex, Cursor, etc.) have no shared memory. Decisions made in one session are lost to others. This protocol makes decisions persist as files, enabling true multi-agent collaboration.
-
-## Rules
-
-- Files in this repository are authoritative.
-- Constraints are hard requirements, not suggestions.
-- Silent architectural or semantic decisions are forbidden.
-- If conflict or ambiguity exists, stop and ask.
-- Shared truth must be written, not remembered.

package/modules/context/TEMPLATES/assumptions.md

@@ -1,4 +0,0 @@
-# Assumptions
-
-- List assumptions currently considered true.
-- Update when assumptions change.

package/modules/context/TEMPLATES/constraints.md

@@ -1,4 +0,0 @@
-# Constraints
-
-- Non-negotiable rules.
-- Must always be followed.

package/modules/context/TEMPLATES/decision.md

@@ -1,16 +0,0 @@
----
-status: open
----
-# DECISION XXXX: <Title>
-
-Date:
-Author:
-
-Context:
-What led to this decision?
-
-Decision:
-What is now considered true?
-
-Implications:
-What must follow from this?

package/modules/context/TEMPLATES/project-context-readme.md

@@ -1,6 +0,0 @@
-# Project AI Context
-
-This directory contains the canonical AI context
-for this project.
-
-All AI agents must read this directory before working.

package/modules/context/TEMPLATES/system.md

@@ -1,3 +0,0 @@
-# System Overview
-
-[Describe the system architecture and purpose]

package/modules/context/TEMPLATES/terminology.md

@@ -1,4 +0,0 @@
-# Terminology
-
-| Term | Definition |
-|------|------------|

package/modules/context/TERMINOLOGY.md

@@ -1,10 +0,0 @@
-# Terminology
-
-| Term | Definition |
-|------|------------|
-| Protocol | The rules defined in this repository |
-| Decision | A recorded change affecting architecture/semantics/behavior |
-| Context | Project-specific knowledge stored in context/ |
-| Handoff | One AI session ending, another beginning |
-| Constraint | Non-negotiable rule |
-| Assumption | Belief currently considered true, subject to change |