james-os

30-Second Pitch

James OS - Full-Stack Operations Intelligence Platform (Avis Budget Group Denver Region) Evidence from the tracked tree: Documentation corpus, Next.js/web app, React UI, Scripted automation, Supabase-backed app/data, Tailwind CSS.

Live State

Doctrine Spine

• README standard: github-readme-standard.md
• Repo deep dive: james-os
• GitHub estate map: github-estate.md
• Source of truth: source-of-truth.md
• Consolidation queue: repo-consolidation-plan.md
• Source-truth hygiene: source-truth-hygiene.md

What This Repo Contains

787 data/config/knowledge-like files; 425 docs/notes; 26 media/design assets; 4 sensitive-path-name matches.

Detected manifests:

• package.json
• pnpm-lock.yaml
• vercel.json

Detected runtime/build signals:

• Documentation corpus
• Next.js/web app
• React UI
• Scripted automation
• Supabase-backed app/data
• Tailwind CSS
• Vercel deployment

File Map

1136 tracked files across 329 directories. Code files: 267. Test files: 37. 787 data/config/knowledge-like files; 425 docs/notes; 26 media/design assets; 4 sensitive-path-name matches.

Aggregate GitHub tree size: 168.0 MB across 1136 blobs. GitHub recursive tree truncated: false.

Top directory size map:

Top tracked directories or roots:

• knowledge-base-james (362)
• packages (302)
• data (252)
• mike-studio (91)
• artifacts (34)
• docs (20)
• . (13)
• inbox (11)
• scraper (11)
• tests (11)
• supabase (7)
• templates (7)

Dominant file extensions:

• .md: 423
• .json: 357
• .py: 84
• .tsx: 83
• .ts: 58
• [none]: 46
• .png: 26
• .html: 14
• .sql: 11
• .js: 7
• .sh: 5
• .mjs: 4

Full public inventory: not published in central docs for this private or non-inventoried repo.

Private repo note: central public estate docs must not expose raw private paths. This repo README uses aggregate counts, categories, and proof links unless Mike approves deeper disclosure.

Runtime / Topology

Mike / Jake / Codex
        |
        v
QNAP Gitea canonical repo
        |
        v
GitHub mirror / collaboration surface
        |
        v
Local worktree / CI / deployment

Provider And Fallback Protocol

Setup

git clone ssh://git@nas94f2ae.tail4d96b3.ts.net:2222/rig/james-os.git
cd james-os
# Install using the package manager or runtime detected above.

Verify

# Run repo-specific tests, lint, typecheck, build, or smoke commands.
# If no command exists yet, add one before promoting this README to final.

Release And Proof Protocol

1. Work on a branch with a clear prefix.
2. Run setup and verification commands.
3. Record a ProofPacket with commit SHA, checks, artifacts, and rollback path.
4. Push to QNAP Gitea first.
5. Verify GitHub mirrors the same result.

Data And Security Boundary

• Visibility: private.
• Never commit secrets, tokens, cookies, browser state, raw credentials, or unapproved private exports.
• Private data should be referenced by source path, count, category, or fingerprint unless the repo itself is the approved private home.

Roadmap

• V0: Repo exists and is mirrored.
• V1: Cold-reader README explains purpose, setup, verification, and proof.
• V2: File map, data boundary, and branch policy are documented.
• V3: CLI/MCP contracts are explicit where the repo owns tools.
• V4: Tests, smoke checks, and deployment protocol are reproducible.
• V5: ProofPacket path records every release or meaningful migration.
• V6: Consolidation action is resolved: keep-separate-private.
• V7: Source cards and capability manifests feed Jake/Susan routing.
• V8: Monitoring and branch hygiene are automated.
• V9: Repo is boring to operate because all paths are canonical.
• V10: Repo is either a clean canonical product surface or archived with proof.

What Is Left

• Add or maintain a cold-reader README, setup command, test command, and ProofPacket path.
• Keep GitHub topics, description, QNAP mirror, and consolidation status current.

README applied from the central RIG blueprint.

• Blueprint source: https://github.com/rodgemd1-lgtm/Startup-Intelligence-OS/blob/claude/rig-sovereign-audit-mesh/docs/repositories/repo-readme-blueprints/james-os.md
• Applied target: james-os
• Source of truth: QNAP Gitea first, GitHub mirror second.

Install The CLI

This repo exposes a standard RIG command so it can be installed, inspected, cloned, and routed into future studio/MCP workflows without guessing its internal layout.

Install without cloning:

curl -fsSL https://github.com/rodgemd1-lgtm/james-os/raw/main/install.sh | bash

Install and clone the source-of-truth repo:

curl -fsSL https://github.com/rodgemd1-lgtm/james-os/raw/main/install.sh | RIG_CLI_CLONE=1 bash

Use it:

james-os info
james-os capabilities
james-os services
james-os clone
james-os doctor

Clone manually:

git clone ssh://git@nas94f2ae.tail4d96b3.ts.net:2222/rig/james-os.git
git clone https://github.com/rodgemd1-lgtm/james-os.git

CLI contract:

• Command: james-os
• Manifest: cli/manifest.json
• Installer: install.sh
• Source of truth: QNAP Gitea first, GitHub mirror second
• Standard: https://github.com/rodgemd1-lgtm/Startup-Intelligence-OS/blob/claude/rig-sovereign-audit-mesh/docs/repositories/repo-cli-standard.md

{
  "name": "james-avis-os",
  "owner": {
    "name": "James Loehr",
    "email": "jloehr2131@gmail.com"
  },
  "metadata": {
    "description": "James AVIS OS plugin marketplace — Denver region city-manager operating system for Avis Budget Group",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "avis-os",
      "source": "./claude-plugins/avis-os",
      "description": "James AVIS OS Claude Code add-on: Daphane PAI 5.0, daily ops briefs, fleet/pricing/NPS routines, connector truth, second brain, SOP harnesses, and proof-gated workflows.",
      "author": {
        "name": "RIG App Studio"
      }
    }
  ]
}