Compare commits
2 Commits
feat/p1p2-
...
docs/frame
| Author | SHA1 | Date | |
|---|---|---|---|
| d91d910196 | |||
| a4c1d79690 |
@@ -18,14 +18,6 @@ steps:
|
||||
- apk add --no-cache python3 make g++
|
||||
- pnpm install --frozen-lockfile
|
||||
|
||||
# Blocking gate: public framework package must contain no operator-specific
|
||||
# personal data or private $HOME defaults. Runs early (no node_modules needed).
|
||||
sanitization:
|
||||
image: *node_image
|
||||
commands:
|
||||
- apk add --no-cache bash
|
||||
- bash packages/mosaic/framework/tools/quality/scripts/verify-sanitized.sh
|
||||
|
||||
typecheck:
|
||||
image: *node_image
|
||||
commands:
|
||||
|
||||
21
LICENSE
21
LICENSE
@@ -1,21 +0,0 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2026 Mosaic Stack
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -23,6 +23,5 @@
|
||||
"turbo": "^2.0.0",
|
||||
"typescript": "^5.8.0",
|
||||
"vitest": "^2.0.0"
|
||||
},
|
||||
"license": "MIT"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2026 Mosaic Stack
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -34,7 +34,7 @@ At session start, additionally:
|
||||
10. Manual `docker build` / `docker push` for deployment is FORBIDDEN when CI/CD pipelines exist in the repository. CI is the ONLY canonical build path for container images.
|
||||
11. Before ANY build or deployment action, you MUST check for existing CI/CD pipeline configuration (`.woodpecker/`, `.woodpecker.yml`, `.github/workflows/`, etc.). If pipelines exist, use them — do not build locally.
|
||||
12. The mandatory intake procedure is NOT conditional on perceived task complexity. A "simple" commit-push-deploy task has the same procedural requirements as a multi-file feature. Skipping intake because a task "seems simple" is the most common framework violation.
|
||||
13. **Merge authority (coordinated work):** when a coordinator/orchestrator session is active for the work, the post-review MERGE GO-AHEAD is the coordinator's to give — once code has passed the required review gates, request the coordinator's go-ahead and merge on their confirmation; do NOT wait on the human owner personally. Solo (uncoordinated) delivery keeps the default: merge without routine confirmation per gates 2 and 9. A "No self-merge" note on a PR means no UNREVIEWED self-merge — it does not suspend coordinator-authorized merges.
|
||||
13. **Merge authority (coordinated work):** when a coordinator/orchestrator session is active for the work, the post-review MERGE GO-AHEAD is the coordinator's to give — once code has passed the required review gates, request the coordinator's go-ahead and merge on their confirmation; do NOT wait on the human owner personally. Solo (uncoordinated) delivery keeps the default: merge without routine confirmation per gates 2 and 9. A "No self-merge" note on a PR means no UNREVIEWED self-merge — it does not suspend coordinator-authorized merges. (Policy: Jason, 2026-06-11.)
|
||||
|
||||
## Non-Negotiable Operating Rules (condensed — full detail in `guides/E2E-DELIVERY.md`)
|
||||
|
||||
|
||||
@@ -69,7 +69,7 @@ It also detects installed runtimes (Claude, Codex, OpenCode, Pi), configures seq
|
||||
For CI or scripted installs:
|
||||
|
||||
```bash
|
||||
mosaic init --non-interactive --name "Mosaic Agent" --style direct --user-name "Your Name" --timezone "UTC"
|
||||
mosaic init --non-interactive --name Jarvis --style direct --user-name Jason --timezone America/Chicago
|
||||
```
|
||||
|
||||
All flags: `--name`, `--role`, `--style`, `--user-name`, `--pronouns`, `--timezone`, `--mosaic-home`, `--source-dir`.
|
||||
|
||||
@@ -5,14 +5,14 @@ It is loaded globally and applies to all sessions regardless of runtime or proje
|
||||
|
||||
## Identity
|
||||
|
||||
You are the **Mosaic agent** in this session.
|
||||
You are **Jarvis** in this session.
|
||||
|
||||
- Runtime (Claude, Codex, OpenCode, etc.) is implementation detail.
|
||||
- Role identity: execution partner and visibility engine
|
||||
|
||||
If asked "who are you?", answer:
|
||||
|
||||
`I am the Mosaic agent, running on <runtime>.`
|
||||
`I am Jarvis, running on <runtime>.`
|
||||
|
||||
## Behavioral Principles
|
||||
|
||||
@@ -20,7 +20,7 @@ If asked "who are you?", answer:
|
||||
2. Practical execution over abstract planning.
|
||||
3. Truthfulness over confidence: state uncertainty explicitly.
|
||||
4. Visible state over hidden assumptions.
|
||||
5. Accessibility-aware: honor the operator's communication and formatting preferences declared in `USER.md`.
|
||||
5. PDA-friendly language, communication style, and iconography. Avoid overwhelming info and communication style..
|
||||
|
||||
## Communication Style
|
||||
|
||||
|
||||
@@ -66,6 +66,12 @@ starts, commits, PRs, test results, or file edits. At session start, `search` +
|
||||
prior context. MCP (`mcp__openbrain__capture/search/recent/stats`) preferred when connected; else
|
||||
REST/`tools/openbrain_client.py`. Full protocol: `guides/MEMORY.md`.
|
||||
|
||||
**MANDATORY jarvis-brain rule:** when working in `~/src/jarvis-brain`, NEVER capture project data,
|
||||
meeting notes, status, timelines, or task completions to OpenBrain — the flat files
|
||||
(`data/projects/*.json`, `data/tasks/*.json`) are the SSOT (use `tools/brain.py` + direct JSON
|
||||
edits). OpenBrain there is for agent meta-observations ONLY (tooling gotchas, framework learnings,
|
||||
cross-project patterns). Violating this creates duplicate, divergent data.
|
||||
|
||||
## Git Providers
|
||||
|
||||
| Host | Instance | CI |
|
||||
|
||||
@@ -1,29 +0,0 @@
|
||||
{
|
||||
"_comment": "EXAMPLE Claude runtime overlay managed by Mosaic. Copy/adapt and merge into ~/.claude/settings.json as needed. Replace the placeholder project paths and skills with your own. Never auto-loaded.",
|
||||
"model": "opus",
|
||||
"additionalAllowedCommands": [
|
||||
"alembic",
|
||||
"alembic upgrade",
|
||||
"alembic downgrade",
|
||||
"uvicorn",
|
||||
"ruff",
|
||||
"ruff check",
|
||||
"ruff format",
|
||||
"black",
|
||||
"isort"
|
||||
],
|
||||
"projectConfigs": {
|
||||
"app": {
|
||||
"path": "~/src/your-app",
|
||||
"model": "opus",
|
||||
"skills": ["prd"],
|
||||
"guides": ["E2E-DELIVERY", "QA-TESTING"]
|
||||
},
|
||||
"review": {
|
||||
"path": "~/src/your-app",
|
||||
"model": "opus",
|
||||
"skills": ["code-review"],
|
||||
"guides": ["CODE-REVIEW"]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,46 +0,0 @@
|
||||
# Example persona — "Execution Partner"
|
||||
|
||||
A worked example of an agent persona (the `SOUL.md` layer). Copy it to
|
||||
`~/.config/mosaic/SOUL.md` and adapt, or generate one with `mosaic init`. This is
|
||||
an **example only** — it is never auto-loaded. Keep operator-specific
|
||||
accommodations (accessibility needs, comms preferences) in your own `USER.md`,
|
||||
not here.
|
||||
|
||||
---
|
||||
|
||||
## Identity
|
||||
|
||||
You are the **Execution Partner** in this session.
|
||||
|
||||
- Runtime (Claude, Codex, OpenCode, etc.) is an implementation detail.
|
||||
- Role identity: execution partner and visibility engine.
|
||||
|
||||
If asked "who are you?", answer: `I am the Execution Partner, running on <runtime>.`
|
||||
|
||||
## Behavioral Principles
|
||||
|
||||
1. Clarity over performance theater.
|
||||
2. Practical execution over abstract planning.
|
||||
3. Truthfulness over confidence: state uncertainty explicitly.
|
||||
4. Visible state over hidden assumptions.
|
||||
5. Accessibility-aware: honor the operator's communication and formatting
|
||||
preferences declared in `USER.md`.
|
||||
|
||||
## Communication Style
|
||||
|
||||
- Be direct, concise, and concrete.
|
||||
- Avoid fluff, hype, and anthropomorphic roleplay.
|
||||
- Do not simulate certainty when facts are missing.
|
||||
- Prefer actionable next steps and explicit tradeoffs.
|
||||
|
||||
## Operating Stance
|
||||
|
||||
- Proactively surface what is hot, stale, blocked, or risky.
|
||||
- Preserve canonical data integrity.
|
||||
- Respect generated-vs-source boundaries.
|
||||
- Treat multi-agent collisions as a first-class risk; sync before/after edits.
|
||||
|
||||
## Why this exists
|
||||
|
||||
Agents should be governed by durable principles, not brittle scripted outputs.
|
||||
The model should reason within constraints, not mimic a fixed response table.
|
||||
@@ -397,11 +397,11 @@ fi
|
||||
### Orchestrator Templates
|
||||
|
||||
| Template | Path | Purpose |
|
||||
| -------------------------------------- | ------------------------------------------ | ----------------------- |
|
||||
| `tasks.md.template` | `~/.config/mosaic/templates/orchestrator/` | Task tracking |
|
||||
| `orchestrator-learnings.json.template` | `~/.config/mosaic/templates/orchestrator/` | Variance tracking |
|
||||
| `phase-issue-body.md.template` | `~/.config/mosaic/templates/orchestrator/` | Git provider issue body |
|
||||
| `scratchpad.md.template` | `~/.config/mosaic/templates/` | Per-task working doc |
|
||||
| -------------------------------------- | ------------------------------------------------- | ----------------------- |
|
||||
| `tasks.md.template` | `~/src/jarvis-brain/docs/templates/orchestrator/` | Task tracking |
|
||||
| `orchestrator-learnings.json.template` | `~/src/jarvis-brain/docs/templates/orchestrator/` | Variance tracking |
|
||||
| `phase-issue-body.md.template` | `~/src/jarvis-brain/docs/templates/orchestrator/` | Git provider issue body |
|
||||
| `scratchpad.md.template` | `~/src/jarvis-brain/docs/templates/` | Per-task working doc |
|
||||
|
||||
### Variables Reference
|
||||
|
||||
|
||||
@@ -124,4 +124,4 @@ Where:
|
||||
## Where to Find Project-Specific Data
|
||||
|
||||
- **Project learnings:** `<project>/docs/tasks/orchestrator-learnings.json`
|
||||
- **Cross-project metrics:** `~/.config/mosaic/orchestrator/metrics.json`
|
||||
- **Cross-project metrics:** `jarvis-brain/data/orchestrator-metrics.json`
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Orchestrator Protocol — Mission Lifecycle Guide
|
||||
|
||||
> **Operational guide for agent sessions.** Distilled from the full specification at
|
||||
> the canonical orchestrator protocol maintained with the framework.
|
||||
> `jarvis-brain/docs/protocols/ORCHESTRATOR-PROTOCOL.md` (1,066 lines).
|
||||
>
|
||||
> Load this guide when: active mission detected, multi-milestone orchestration, mission continuation.
|
||||
> Load `ORCHESTRATOR.md` for per-session execution protocol (planning, coding, review, commit cycle).
|
||||
@@ -194,7 +194,7 @@ This is the confirmed, most common failure. Every session will eventually trigge
|
||||
|
||||
## 8. r0 Manual Coordinator Process
|
||||
|
||||
In r0, the Coordinator is a human operator + shell scripts. No daemon. No automation.
|
||||
In r0, the Coordinator is Jason + shell scripts. No daemon. No automation.
|
||||
|
||||
### Commands
|
||||
|
||||
|
||||
@@ -96,7 +96,7 @@ In Matrix rail mode, keep `docs/TASKS.md` as canonical project tracking and use
|
||||
|
||||
## Bootstrap Templates
|
||||
|
||||
Use templates from `~/.config/mosaic/templates/` to scaffold tracking files:
|
||||
Use templates from `jarvis-brain/docs/templates/` to scaffold tracking files:
|
||||
|
||||
```bash
|
||||
# Set environment variables
|
||||
@@ -108,7 +108,7 @@ export PHASE_ISSUE="#1"
|
||||
export PHASE_BRANCH="fix/security"
|
||||
|
||||
# Copy templates
|
||||
TEMPLATES=~/.config/mosaic/templates
|
||||
TEMPLATES=~/src/jarvis-brain/docs/templates
|
||||
|
||||
# Create PRD if missing (before coding begins)
|
||||
[[ -f docs/PRD.md || -f docs/PRD.json ]] || cp ~/.config/mosaic/templates/docs/PRD.md.template docs/PRD.md
|
||||
@@ -149,7 +149,7 @@ Branch and merge strategy (HARD RULE):
|
||||
| `reports/review-report-scaffold.sh` | Creates report directory |
|
||||
| `scratchpad.md.template` | Per-task working document |
|
||||
|
||||
See `~/.config/mosaic/templates/README.md` for full documentation.
|
||||
See `jarvis-brain/docs/templates/README.md` for full documentation.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -146,6 +146,8 @@ load_credentials <service-name>
|
||||
|
||||
Self-hosted semantic brain backed by pgvector. Primary shared memory layer for all agents across all sessions and harnesses. Stores and retrieves decisions, context, and observations via semantic search.
|
||||
|
||||
**MANDATORY jarvis-brain rule:** When working in `~/src/jarvis-brain`, NEVER capture project data, meeting notes, status updates, timeline decisions, or task completions to OpenBrain. The flat files (`data/projects/*.json`, `data/tasks/*.json`) are the SSOT — use `tools/brain.py` and direct JSON edits. OpenBrain is for agent meta-observations ONLY (tooling gotchas, framework learnings, cross-project patterns). Violating this creates duplicate, divergent data.
|
||||
|
||||
**Credentials:** `load_credentials openbrain` → exports `OPENBRAIN_URL`, `OPENBRAIN_TOKEN`
|
||||
|
||||
Configure in your credentials.json:
|
||||
@@ -177,7 +179,7 @@ curl -s -H "Authorization: Bearer $OPENBRAIN_TOKEN" "$OPENBRAIN_URL/v1/thoughts/
|
||||
curl -s -H "Authorization: Bearer $OPENBRAIN_TOKEN" "$OPENBRAIN_URL/v1/stats"
|
||||
```
|
||||
|
||||
**Python client** (if the OpenBrain client is on your PYTHONPATH):
|
||||
**Python client** (if jarvis-brain is available on PYTHONPATH):
|
||||
|
||||
```bash
|
||||
python tools/openbrain_client.py search "topic"
|
||||
@@ -221,7 +223,7 @@ Headless `.excalidraw` → SVG export via `@excalidraw/excalidraw`. Available as
|
||||
**Diagram generation** (`list_diagrams`, `generate_diagram`, `generate_and_export`) requires `EXCALIDRAW_GEN_PATH` env var pointing to `excalidraw_gen.py`. Set in environment or shell profile:
|
||||
|
||||
```bash
|
||||
export EXCALIDRAW_GEN_PATH="$HOME/.config/mosaic/tools/excalidraw/excalidraw_gen.py"
|
||||
export EXCALIDRAW_GEN_PATH="$HOME/src/jarvis-brain/tools/excalidraw_export/excalidraw_gen.py"
|
||||
```
|
||||
|
||||
**Manual registration:**
|
||||
|
||||
@@ -15,7 +15,7 @@ Profiles are runtime-neutral context packs that can be consumed by any agent run
|
||||
|
||||
Current runtime overlay example:
|
||||
|
||||
- `examples/overlays/e2e-loop.json`
|
||||
- `~/.config/mosaic/runtime/claude/settings-overlays/jarvis-loop.json`
|
||||
|
||||
## Claude Compatibility
|
||||
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
{
|
||||
"_comment": "Claude runtime overlay managed by Mosaic. Merge into ~/.claude/settings.json as needed.",
|
||||
"model": "opus",
|
||||
"additionalAllowedCommands": [
|
||||
"alembic",
|
||||
"alembic upgrade",
|
||||
"alembic downgrade",
|
||||
"alembic revision",
|
||||
"alembic history",
|
||||
"uvicorn",
|
||||
"fastapi",
|
||||
"ruff",
|
||||
"ruff check",
|
||||
"ruff format",
|
||||
"black",
|
||||
"isort",
|
||||
"httpx"
|
||||
],
|
||||
"projectConfigs": {
|
||||
"jarvis": {
|
||||
"path": "~/src/jarvis",
|
||||
"model": "opus",
|
||||
"skills": ["jarvis", "prd"],
|
||||
"guides": [
|
||||
"E2E-DELIVERY",
|
||||
"PRD",
|
||||
"BACKEND",
|
||||
"FRONTEND",
|
||||
"AUTHENTICATION",
|
||||
"QA-TESTING",
|
||||
"CODE-REVIEW"
|
||||
],
|
||||
"env": {
|
||||
"PYTHONPATH": "packages/plugins"
|
||||
}
|
||||
}
|
||||
},
|
||||
"presets": {
|
||||
"jarvis-loop": {
|
||||
"description": "Embedded E2E delivery cycle for Jarvis",
|
||||
"model": "opus",
|
||||
"skills": ["jarvis", "prd"],
|
||||
"systemPrompt": "You are an autonomous coding agent. For each logical unit, execute: plan, code, test, review, remediate, review, commit, push, then run a greenfield situational test. Repeat until requirements are complete."
|
||||
},
|
||||
"jarvis-review": {
|
||||
"description": "Code review mode for Jarvis PRs",
|
||||
"model": "opus",
|
||||
"skills": ["jarvis"],
|
||||
"guides": ["CODE-REVIEW"],
|
||||
"systemPrompt": "Review code changes for quality, security, and adherence to Jarvis patterns."
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -35,7 +35,7 @@ Example:
|
||||
```dotenv
|
||||
MOSAIC_TMUX_SOCKET=mosaic-factory
|
||||
MOSAIC_AGENT_RUNTIME=claude
|
||||
MOSAIC_AGENT_WORKDIR=$HOME/src/your-project
|
||||
MOSAIC_AGENT_WORKDIR=/home/jarvis/src/mosaic-stack
|
||||
# Optional escape hatch for PoC/canary agents:
|
||||
# MOSAIC_AGENT_COMMAND=mosaic yolo claude
|
||||
```
|
||||
|
||||
@@ -17,10 +17,10 @@
|
||||
# Run `load_credentials --help` for details.
|
||||
|
||||
if [[ -z "${MOSAIC_CREDENTIALS_FILE:-}" ]]; then
|
||||
for _cand in "$HOME/.config/mosaic/credentials.json"; do
|
||||
for _cand in "$HOME/.config/mosaic/credentials.json" "$HOME/src/jarvis-brain/credentials.json"; do
|
||||
if [[ -f "$_cand" ]]; then MOSAIC_CREDENTIALS_FILE="$_cand"; break; fi
|
||||
done
|
||||
: "${MOSAIC_CREDENTIALS_FILE:=$HOME/.config/mosaic/credentials.json}"
|
||||
: "${MOSAIC_CREDENTIALS_FILE:=$HOME/src/jarvis-brain/credentials.json}"
|
||||
fi
|
||||
|
||||
_mosaic_require_jq() {
|
||||
|
||||
@@ -309,7 +309,7 @@ if [[ -f "$pi_settings" ]]; then
|
||||
fi
|
||||
|
||||
# Mosaic-specific skills presence check.
|
||||
mosaic_skills=(mosaic-board mosaic-forge mosaic-prdy mosaic-macp mosaic-standards mosaic-prd mosaic-setup-cicd)
|
||||
mosaic_skills=(mosaic-board mosaic-forge mosaic-prdy mosaic-macp mosaic-standards mosaic-prd mosaic-jarvis mosaic-setup-cicd)
|
||||
for skill_name in "${mosaic_skills[@]}"; do
|
||||
if [[ -d "$MOSAIC_HOME/skills/$skill_name" ]] || [[ -L "$MOSAIC_HOME/skills/$skill_name" ]]; then
|
||||
pass "Mosaic skill present: $skill_name"
|
||||
|
||||
@@ -5,8 +5,8 @@ set -euo pipefail
|
||||
#
|
||||
# Usage:
|
||||
# mosaic-init # Interactive mode
|
||||
# mosaic-init --name "Mosaic Agent" --style direct # Flag overrides
|
||||
# mosaic-init --name "Mosaic Agent" --role "memory steward" --style direct \
|
||||
# mosaic-init --name "Jarvis" --style direct # Flag overrides
|
||||
# mosaic-init --name "Jarvis" --role "memory steward" --style direct \
|
||||
# --accessibility "ADHD-friendly chunking" --guardrails "Never auto-commit"
|
||||
|
||||
MOSAIC_HOME="${MOSAIC_HOME:-$HOME/.config/mosaic}"
|
||||
@@ -50,7 +50,7 @@ Generate Mosaic identity and configuration files:
|
||||
Interactive by default. Use flags to skip prompts.
|
||||
|
||||
Options:
|
||||
--name <name> Agent name (e.g., "Mosaic Agent", "Assistant")
|
||||
--name <name> Agent name (e.g., "Jarvis", "Assistant")
|
||||
--role <description> Role description (e.g., "memory steward, execution partner")
|
||||
--style <style> Communication style: direct, friendly, or formal
|
||||
--accessibility <prefs> Accessibility preferences (e.g., "ADHD-friendly chunking")
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
#
|
||||
# Usage:
|
||||
# mosaic-init.ps1 # Interactive mode
|
||||
# mosaic-init.ps1 -Name "Mosaic Agent" -Style direct # Flag overrides
|
||||
# mosaic-init.ps1 -Name "Jarvis" -Style direct # Flag overrides
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
param(
|
||||
|
||||
@@ -62,6 +62,7 @@ legacy_paths=(
|
||||
"$HOME/.claude/presets/domains"
|
||||
"$HOME/.claude/presets/tech-stacks"
|
||||
"$HOME/.claude/presets/workflows"
|
||||
"$HOME/.claude/presets/jarvis-loop.json"
|
||||
)
|
||||
|
||||
for p in "${legacy_paths[@]}"; do
|
||||
|
||||
@@ -70,6 +70,7 @@ $legacyPaths = @(
|
||||
(Join-Path $env:USERPROFILE ".claude\presets\domains"),
|
||||
(Join-Path $env:USERPROFILE ".claude\presets\tech-stacks"),
|
||||
(Join-Path $env:USERPROFILE ".claude\presets\workflows"),
|
||||
(Join-Path $env:USERPROFILE ".claude\presets\jarvis-loop.json")
|
||||
)
|
||||
|
||||
foreach ($p in $legacyPaths) {
|
||||
|
||||
@@ -8,7 +8,7 @@ usage() {
|
||||
cat <<USAGE
|
||||
Usage: $(basename "$0") [--apply]
|
||||
|
||||
Migrate runtime-local skill directories (e.g. ~/.claude/skills/<name>) to Mosaic-managed
|
||||
Migrate runtime-local skill directories (e.g. ~/.claude/skills/jarvis) to Mosaic-managed
|
||||
skills by replacing local directories with symlinks to ~/.config/mosaic/skills-local.
|
||||
|
||||
Default mode is dry-run.
|
||||
|
||||
@@ -16,7 +16,7 @@ if ($Help) {
|
||||
Write-Host @"
|
||||
Usage: mosaic-migrate-local-skills.ps1 [-Apply] [-Help]
|
||||
|
||||
Migrate runtime-local skill directories (e.g. ~/.claude/skills/<name>) to
|
||||
Migrate runtime-local skill directories (e.g. ~/.claude/skills/jarvis) to
|
||||
Mosaic-managed skills by replacing local directories with junctions to
|
||||
~/.config/mosaic/skills-local.
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@ Manage Authentik identity provider (SSO, users, groups, applications, flows) via
|
||||
## Prerequisites
|
||||
|
||||
- `jq` installed
|
||||
- Authentik credentials in `~/.config/mosaic/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- Authentik credentials in `~/src/jarvis-brain/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- Required fields: `authentik.url`, `authentik.username`, `authentik.password`
|
||||
|
||||
## Authentication
|
||||
@@ -47,7 +47,7 @@ All scripts support:
|
||||
~/.config/mosaic/tools/authentik/user-list.sh
|
||||
|
||||
# Search for a user
|
||||
~/.config/mosaic/tools/authentik/user-list.sh -s "alice"
|
||||
~/.config/mosaic/tools/authentik/user-list.sh -s "jason"
|
||||
|
||||
# Create a user in the admins group
|
||||
~/.config/mosaic/tools/authentik/user-create.sh -u newuser -n "New User" -e new@example.com -g admins
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
# Usage:
|
||||
# agent-lint.sh # Scan all projects in ~/src/
|
||||
# agent-lint.sh --project <path> # Scan single project
|
||||
# agent-lint.sh --json # Output JSON for machine consumption
|
||||
# agent-lint.sh --json # Output JSON for jarvis-brain
|
||||
# agent-lint.sh --verbose # Show per-check details
|
||||
# agent-lint.sh --fix-hint # Show fix commands for failures
|
||||
#
|
||||
|
||||
@@ -5,7 +5,7 @@ Manage Coolify container deployment platform (projects, services, deployments, e
|
||||
## Prerequisites
|
||||
|
||||
- `jq` and `curl` installed
|
||||
- Coolify credentials in `~/.config/mosaic/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- Coolify credentials in `~/src/jarvis-brain/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- Required fields: `coolify.url`, `coolify.app_token`
|
||||
|
||||
## Scripts
|
||||
|
||||
@@ -86,7 +86,7 @@ gitea_url_matches_host() {
|
||||
|
||||
get_gitea_service_for_host() {
|
||||
local host="$1"
|
||||
local cred_file="${MOSAIC_CREDENTIALS_FILE:-$HOME/.config/mosaic/credentials.json}"
|
||||
local cred_file="${MOSAIC_CREDENTIALS_FILE:-$HOME/src/jarvis-brain/credentials.json}"
|
||||
|
||||
case "$host" in
|
||||
git.mosaicstack.dev)
|
||||
|
||||
@@ -39,7 +39,7 @@ if [[ "$*" == "login list --output json" ]]; then
|
||||
cat <<'JSON'
|
||||
[
|
||||
{"name":"evil-usc","url":"https://evilgit.uscllc.com","user":"bad.actor"},
|
||||
{"name":"usc","url":"https://git.uscllc.com","user":"ci-bot"}
|
||||
{"name":"usc","url":"https://git.uscllc.com","user":"jason.woltje"}
|
||||
]
|
||||
JSON
|
||||
exit 0
|
||||
@@ -263,8 +263,8 @@ set -euo pipefail
|
||||
if [[ "$*" == "login list --output json" ]]; then
|
||||
cat <<'JSON'
|
||||
[
|
||||
{"name":"mosaicstack","url":"https://git.mosaicstack.dev","user":"ci-bot"},
|
||||
{"name":"usc","url":"https://git.uscllc.com","user":"ci-bot"}
|
||||
{"name":"mosaicstack","url":"https://git.mosaicstack.dev","user":"jason.woltje"},
|
||||
{"name":"usc","url":"https://git.uscllc.com","user":"jason.woltje"}
|
||||
]
|
||||
JSON
|
||||
exit 0
|
||||
|
||||
@@ -49,7 +49,7 @@ set -euo pipefail
|
||||
if [[ "$*" == "login list --output json" ]]; then
|
||||
cat <<'JSON'
|
||||
[
|
||||
{"name":"mosaicstack","url":"https://git.mosaicstack.dev","user":"ci-bot"}
|
||||
{"name":"mosaicstack","url":"https://git.mosaicstack.dev","user":"jason.woltje"}
|
||||
]
|
||||
JSON
|
||||
exit 0
|
||||
|
||||
@@ -5,7 +5,7 @@ Manage GLPI IT service management (tickets, computers/assets, users).
|
||||
## Prerequisites
|
||||
|
||||
- `jq` and `curl` installed
|
||||
- GLPI credentials in `~/.config/mosaic/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- GLPI credentials in `~/src/jarvis-brain/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
||||
- Required fields: `glpi.url`, `glpi.app_token`, `glpi.user_token`
|
||||
|
||||
## Authentication
|
||||
|
||||
@@ -20,7 +20,7 @@ source "$MOSAIC_HOME/tools/_lib/credentials.sh"
|
||||
FORMAT="table"
|
||||
SINGLE_SERVICE=""
|
||||
QUIET=false
|
||||
CRED_FILE="${MOSAIC_CREDENTIALS_FILE:-$HOME/.config/mosaic/credentials.json}"
|
||||
CRED_FILE="${MOSAIC_CREDENTIALS_FILE:-$HOME/src/jarvis-brain/credentials.json}"
|
||||
|
||||
while getopts "f:s:qh" opt; do
|
||||
case $opt in
|
||||
|
||||
@@ -26,11 +26,7 @@ FILE_PATH="${FILE_PATH/#\~/$HOME}"
|
||||
# Block writes to Claude Code auto-memory files
|
||||
if [[ "$FILE_PATH" =~ /.claude/projects/.+/memory/.*\.md$ ]]; then
|
||||
echo "BLOCKED: Do not write agent learnings to ~/.claude/projects/*/memory/ — this is a runtime-specific silo."
|
||||
if [[ -n "${OPENBRAIN_URL:-}" ]]; then
|
||||
echo "Use OpenBrain instead: MCP 'capture' tool or REST POST ${OPENBRAIN_URL%/}/v1/thoughts"
|
||||
else
|
||||
echo "Use OpenBrain instead: the 'capture' MCP tool (set OPENBRAIN_URL for the REST endpoint)."
|
||||
fi
|
||||
echo "Use OpenBrain instead: MCP 'capture' tool or REST POST https://brain.woltje.com/v1/thoughts"
|
||||
echo "File blocked: $FILE_PATH"
|
||||
exit 2
|
||||
fi
|
||||
|
||||
@@ -1,86 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# verify-sanitized.sh — blocking CI gate: the public framework package must
|
||||
# contain no operator-specific personal data or private executable defaults.
|
||||
#
|
||||
# Two rule classes:
|
||||
# 1. STRUCTURAL — operator-independent invariants (private $HOME defaults in *.sh).
|
||||
# 2. DENYLIST — a LABELED, one-time regression guard for the CURRENT operator's
|
||||
# identity tokens. This is NOT a general PII detector (a future
|
||||
# operator's name can't be enumerated); the durable control is the
|
||||
# L0 prose firewall + human review. This gate just stops *this*
|
||||
# contamination from coming back.
|
||||
#
|
||||
# Scope: all of the framework package — *.md, *.sh, *.ps1, and the CLI scripts under
|
||||
# tools/_scripts/ (which are extensionless). Excluded: examples/ (holds
|
||||
# sanitized, placeholdered worked examples), node_modules/, and this gate file.
|
||||
#
|
||||
# NOTE on scope: private THIRD-PARTY host references (e.g. a maintainer's employer
|
||||
# Gitea) are intentionally NOT in this denylist — they are functionally entangled in
|
||||
# host-routing + test fixtures and are tracked as a separate follow-up.
|
||||
#
|
||||
# Self-tests run first: plant known tokens and assert the scan catches them, so a
|
||||
# broken regex cannot silently no-op the gate.
|
||||
#
|
||||
# Usage: verify-sanitized.sh [FRAMEWORK_ROOT]
|
||||
set -uo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
FRAMEWORK_ROOT="${1:-$(cd "$SCRIPT_DIR/../../.." && pwd)}"
|
||||
SELF_REL="tools/quality/scripts/verify-sanitized.sh"
|
||||
|
||||
# Labeled current-contaminant denylist. Anchored so substrings like "comparison" or
|
||||
# "jsonwebtoken" do not match. (jarvis-brain is caught by 'jarvis'.)
|
||||
DENYLIST='jarvis|jason|woltje|brain\.woltje\.com|/home/jwoltje|\bPDA\b'
|
||||
|
||||
# Structural: a private $HOME path used as a shell default (e.g. ${VAR:-$HOME/src/...}).
|
||||
STRUCTURAL_SH=':[-=]\$\{?HOME\}?/src/'
|
||||
|
||||
# Build the in-scope file list once (NUL-delimited).
|
||||
_scope_files() {
|
||||
find "$FRAMEWORK_ROOT" -type f \
|
||||
\( -name '*.md' -o -name '*.sh' -o -name '*.ps1' -o -path '*/tools/_scripts/*' \) \
|
||||
-not -path '*/examples/*' \
|
||||
-not -path '*/node_modules/*' \
|
||||
-not -path "*/$SELF_REL" \
|
||||
-print0
|
||||
}
|
||||
|
||||
fail=0
|
||||
cd "$FRAMEWORK_ROOT" || { echo "FRAMEWORK_ROOT not found: $FRAMEWORK_ROOT" >&2; exit 3; }
|
||||
|
||||
deny_hits="$(_scope_files | xargs -0 -r grep -nIEi "$DENYLIST" 2>/dev/null || true)"
|
||||
if [[ -n "$deny_hits" ]]; then
|
||||
echo "✗ [denylist] operator-identity tokens in shipped files:"
|
||||
echo "$deny_hits" | sed "s#$FRAMEWORK_ROOT/##; s/^/ /"
|
||||
fail=1
|
||||
fi
|
||||
|
||||
struct_hits="$(_scope_files | xargs -0 -r grep -nIE "$STRUCTURAL_SH" 2>/dev/null \
|
||||
| grep -E '\.sh:|/tools/_scripts/' || true)"
|
||||
if [[ -n "$struct_hits" ]]; then
|
||||
echo "✗ [structural] private \$HOME/src default in a shipped script:"
|
||||
echo "$struct_hits" | sed "s#$FRAMEWORK_ROOT/##; s/^/ /"
|
||||
fail=1
|
||||
fi
|
||||
|
||||
# ---- self-test: the gate must catch planted tokens ----
|
||||
_selftest() {
|
||||
local tmp; tmp="$(mktemp -d)" || return 1
|
||||
printf 'contact jason.woltje at jarvis-brain (PDA note)\n' > "$tmp/planted.md"
|
||||
printf 'X="${VAR:-$HOME/src/whatever/x.json}"\n' > "$tmp/planted.sh"
|
||||
local ok=0
|
||||
grep -qIEi "$DENYLIST" "$tmp/planted.md" || { echo "✗ SELF-TEST: denylist regex broken" >&2; ok=1; }
|
||||
grep -qIE "$STRUCTURAL_SH" "$tmp/planted.sh" || { echo "✗ SELF-TEST: structural regex broken" >&2; ok=1; }
|
||||
rm -rf "$tmp"
|
||||
return $ok
|
||||
}
|
||||
_selftest || exit 2
|
||||
|
||||
if [[ "$fail" -ne 0 ]]; then
|
||||
echo
|
||||
echo "Sanitization gate FAILED. Public framework files must not contain operator identity" >&2
|
||||
echo "or private \$HOME defaults. Move personal content to init-generated files or examples/." >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "✓ sanitization gate passed (framework *.md/*.sh/*.ps1/_scripts; examples/ excluded)"
|
||||
@@ -5,7 +5,7 @@ Interact with Woodpecker CI pipelines (list builds, check status, trigger builds
|
||||
## Prerequisites
|
||||
|
||||
- `jq` and `curl` installed
|
||||
- Woodpecker credentials in `~/.config/mosaic/credentials.json`
|
||||
- Woodpecker credentials in `~/src/jarvis-brain/credentials.json`
|
||||
|
||||
## Setup
|
||||
|
||||
|
||||
@@ -63,6 +63,5 @@
|
||||
"files": [
|
||||
"dist",
|
||||
"framework"
|
||||
],
|
||||
"license": "MIT"
|
||||
]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user