openfleet 0.1.0

package/dist/templates/.openfleet/README.md

@@ -0,0 +1,52 @@
+# ⛴️ Openfleet
+
+Long-term project management with built in self-healing capabilities
+managed by agent fleet.
+
+This directory is meant to be managed by Openfleet agents, and is typically
+not for humans, though it would be difficult to mess this up unintentionally.
+
+## For Agents 🤖
+
+Understand `## Structure`, then see `./status/current.md`, and other necessary
+files before starting your current task.
+
+## Structure
+
+```
+.openfleet/
+├── README.md
+├── status/
+│   ├── current.md         # Anchor point - agent reads this first
+│   └── README.md
+├── sessions/              # Agent transcripts / journals
+│   └── README.md
+├── stories/               # Work organized by story/epic
+│   ├── README.md
+│   └── unassigned/
+│       └── README.md
+├── docs/
+│   ├── README.md
+│   └── working/           # Agent scratch space
+│       └── README.md
+├── experience/            # Self-healing long term memory
+│   ├── README.md
+│   ├── Mnemosyne.md
+│   ├── runbooks/          # Used for recurring tasks, like Claude Agent Skills
+│   ├── troubleshooting/   # Used for common errors
+│   ├── lessons/           # Used for learning from past mistakes
+│   └── blunders/          # Used for learning from stupid mistakes
+├── standards/
+│   ├── README.md
+│   ├── code-style.md
+│   ├── architecture.md
+│   ├── testing.md
+│   └── review-checklist.md
+└── reviews/               # Human review artifacts
+    └── README.md
+```
+
+## Flexibility
+
+This template is a _general_ guide for project management. Feel free to customize
+as you wish.

package/dist/templates/.openfleet/docs/README.md

@@ -0,0 +1,51 @@
+# Documentation Directory
+
+Design documents and working notes.
+
+## Structure
+
+```
+docs/
+├── README.md              # This file
+├── adr/                   # Architecture decision records
+│   └── 001-use-postgres.md
+├── guides/                # How-to guides for humans
+│   └── local-development.md
+└── working/               # Agent scratch space for drafts
+    └── <document-name>.md
+```
+
+## File naming
+
+Use lowercase kebab-case:
+
+- `openfleet-v2-hld.md`
+- `auth-redesign-proposal.md`
+- `api-migration-plan.md`
+
+## Usage
+
+The `working/` directory is for temporary documents being drafted by agents.
+Once finalized, move docs to appropriate directories under `docs/` or `stories/`.
+
+## Format
+
+Working documents are freeform, but commonly include:
+
+```markdown
+# <Document title>
+
+## Overview
+
+<Brief description of what this document covers>
+
+## <Section 1>
+
+<Content>
+
+## <Section 2>
+
+<Content>
+```
+
+For design docs specifically (HLD/LLD), see the story task format in `stories/README.md`.

package/dist/templates/.openfleet/docs/working/README.md

@@ -0,0 +1,5 @@
+# Working Documents
+
+Agent scratch space for drafts and work-in-progress documents.
+
+Files here are temporary. Move finalized docs to appropriate story directories.

package/dist/templates/.openfleet/experience/Mnemosyne.md

@@ -0,0 +1,170 @@
+# Mnemosyne
+
+_The goddess of memory and mother of the Muses._
+
+This is the index of accumulated experience. Consult before tackling unfamiliar problems.
+
+## Recent Activity
+
+_No activity yet._
+
+### Runbooks
+
+_No runbooks yet._
+
+### Troubleshooting Guides
+
+_No guides yet._
+
+### Lessons Learned
+
+_No lessons yet._
+
+### Blunders to Avoid
+
+_No blunders recorded._
+
+---
+
+## File Naming Conventions
+
+### Runbooks
+
+Use lowercase kebab-case: `<task-name>.md`
+
+- `deploy-to-production.md`
+- `rotate-api-keys.md`
+- `onboard-new-service.md`
+
+### Troubleshooting
+
+Use lowercase with underscore: `<error-type>_<context>.md`
+
+- `build-failure_missing-deps.md`
+- `runtime-error_null-pointer.md`
+- `test-flake_async-timing.md`
+
+### Lessons
+
+Use lowercase kebab-case with suffix: `<topic>-lesson.md`
+
+- `prefer-composition-over-inheritance-lesson.md`
+- `batch-database-queries-lesson.md`
+- `early-return-pattern-lesson.md`
+
+### Blunders
+
+Use lowercase kebab-case with suffix: `<descriptive-name>-blunder.md`
+
+- `api-key-exposure-blunder.md`
+- `missing-null-check-blunder.md`
+- `wrong-environment-deploy-blunder.md`
+
+---
+
+## Templates
+
+### Runbook
+
+```markdown
+# <Task name>
+
+## Purpose
+
+<What this runbook accomplishes>
+
+## Prerequisites
+
+- <What's needed before starting>
+- <Required access, tools, etc.>
+
+## Steps
+
+1. <First actionable step>
+2. Run `scripts/deploy.sh --env staging`
+3. <Can reference scripts in the repo>
+
+## Verification
+
+- <How to confirm success>
+- <Expected outcomes>
+```
+
+### Troubleshooting
+
+```markdown
+# <Error type>: <Brief description>
+
+## Symptoms
+
+- <How the problem manifests>
+- <Error messages, behaviors observed>
+
+## Root cause
+
+<Why this happens - the underlying reason>
+
+## Solution
+
+1. <Step to fix>
+2. <Next step>
+3. <Continue as needed>
+
+## Prevention
+
+- <How to avoid this in the future>
+- <Configuration, practices to adopt>
+```
+
+### Lesson
+
+```markdown
+# <Brief title of the lesson>
+
+## Context
+
+<When/where this was learned - the situation that led to this insight>
+
+## Insight
+
+<The key learning - what was discovered>
+
+## Application
+
+- <How to apply this going forward>
+- <Specific practices to adopt>
+
+## Related
+
+- <Links to relevant docs, code, or external resources>
+```
+
+### Blunder
+
+```markdown
+# <Brief title describing the blunder>
+
+## What happened
+
+<Description of the mistake - what was done wrong>
+
+## Impact
+
+<What went wrong as a result - consequences>
+
+## Root cause
+
+<Why it happened - the underlying reason>
+
+## Prevention
+
+<How to avoid this in the future - proactive measures>
+
+## Detection
+
+<How to catch early if it happens again - monitoring/review steps>
+```
+
+---
+
+_Updated when new experience is captured._

package/dist/templates/.openfleet/experience/README.md

@@ -0,0 +1,23 @@
+# Experience Directory
+
+Self-healing systems with long-term memory. Learned knowledge from past work.
+
+## Structure
+
+```
+experience/
+├── Mnemosyne.md           # Ignore unless you're the Reflect agent
+├── runbooks/              # How-to guides for recurring tasks
+├── troubleshooting/       # Problem → solution mappings
+├── lessons/               # Insights and best practices
+└── blunders/              # Mistakes to avoid
+```
+
+## Usage
+
+Consult this directory to:
+
+- Find solutions to previously-solved problems
+- Follow established procedures
+- Avoid repeating past mistakes
+- Apply learned best practices

package/dist/templates/.openfleet/experience/blunders/README.md

@@ -0,0 +1,6 @@
+# Blunders
+
+Mistakes to avoid. Learning from failure.
+
+This is not a blame log. It's a learning resource.
+Recording blunders helps prevent repeating them.

package/dist/templates/.openfleet/experience/lessons/README.md

@@ -0,0 +1,3 @@
+# Lessons Learned
+
+Insights and best practices discovered through experience.

package/dist/templates/.openfleet/experience/runbooks/README.md

@@ -0,0 +1,3 @@
+# Runbooks
+
+Step-by-step guides for recurring tasks.

package/dist/templates/.openfleet/experience/troubleshooting/README.md

@@ -0,0 +1,3 @@
+# Troubleshooting
+
+Problem → solution mappings for quick reference.

package/dist/templates/.openfleet/reviews/README.md

@@ -0,0 +1,15 @@
+# Reviews
+
+Human review artifacts and feedback.
+
+## Structure
+
+```
+reviews/
+├── README.md                    # This file
+└── YYYY-MM-DD_<topic>.md        # Individual review records
+```
+
+## Usage
+
+Store feedback from human reviews here for future reference.

package/dist/templates/.openfleet/sessions/README.md

@@ -0,0 +1,16 @@
+# Sessions Directory
+
+Conversation records organized by date.
+
+## Structure
+
+```
+sessions/
+└── YYYY-MM-DD/
+    └── NNN_topic-slug.md
+```
+
+## Usage
+
+Sessions are auto-generated by the `save_conversation` tool.
+Each session captures a complete conversation with metadata.

package/dist/templates/.openfleet/standards/README.md

@@ -0,0 +1,18 @@
+# Standards Directory
+
+Prescriptive guidelines for consistency and quality.
+
+## Files
+
+- `architecture.md`: Architectural patterns
+- `code-style.md`: Coding conventions
+- `testing.md`: Testing requirements
+- `review-checklist.md`: PR review criteria
+
+## Usage
+
+Agents reference these standards when:
+
+- Writing new code
+- Reviewing changes
+- Making architectural decisions

package/dist/templates/.openfleet/standards/architecture.md

@@ -0,0 +1,3 @@
+# Architecture Standards
+
+_To be customized for your project._

package/dist/templates/.openfleet/standards/code-style.md

@@ -0,0 +1,3 @@
+# Code Style Standards
+
+_To be customized for your project._

package/dist/templates/.openfleet/standards/review-checklist.md

@@ -0,0 +1,3 @@
+# Review Checklist
+
+_To be customized for your project._

package/dist/templates/.openfleet/standards/testing.md

@@ -0,0 +1,3 @@
+# Testing Standards
+
+_To be customized for your project._

package/dist/templates/.openfleet/status/README.md

@@ -0,0 +1,15 @@
+# Status Directory
+
+The anchor point for agent context. Always read `current.md` first.
+
+## Files
+
+- `current.md`: Current work status, active story, recent sessions
+
+## Usage
+
+All agents will read this file on startup for working context.
+
+## Git commit preference
+
+_Undecided between **submit as PR** or **NEVER MAKE ANY COMMITS**_

package/dist/templates/.openfleet/status/current.md

@@ -0,0 +1,29 @@
+# Current Status
+
+**Last Updated**: 2026-01-04T04:09:33.840Z
+**Active Story**: _none_
+**Status**: idle
+
+## Current Work
+
+_No active work._
+
+## Active Tasks
+
+_None._
+
+## Recent Sessions
+
+- `001_investigate-openfleet-directory.md` (2026-01-04) [188 messages, 74.5K tokens] ← current session
+
+---
+
+## Quick Stats
+
+- Sessions today: 1
+- Sessions this week: 1
+- Last housekeeping: 2026-01-04T04:10:15Z
+
+---
+
+_Updated by agents and tools automatically._

package/dist/templates/.openfleet/stories/README.md

@@ -0,0 +1,86 @@
+# Stories Directory
+
+Work organized by story (epic-level grouping).
+
+## Structure
+
+```
+stories/
+├── README.md                           # This file
+├── YYYY-WXX/                           # Week-based organization
+│   └── <story-name>/
+│       ├── README.md                   # Story overview
+│       └── tasks/
+│           └── MM-DD_<task-name>/
+│               ├── Research.md         # Scout the topic
+│               ├── HLD.md              # High-level design
+│               └── LLD.md              # Low-level design
+└── unassigned/                         # Tasks without a story
+```
+
+## Naming conventions
+
+- **Week directories**: `YYYY-WXX` (e.g., `2026-W01`)
+- **Story directories**: lowercase kebab-case (e.g., `auth-redesign`, `openfleet-v2`)
+- **Task directories**: `MM-DD_<task-name>` (e.g., `01-03_implement-save-conversation`)
+
+## Usage
+
+Stories group related tasks under a common theme or epic.
+Use week-based directories to organize by time period.
+
+## Story README format
+
+```markdown
+# <Story name>
+
+## Goal
+
+<What this story aims to accomplish>
+
+## Tasks
+
+- [ ] <Task 1>
+- [ ] <Task 2>
+
+## Status
+
+<Current status: planning | in-progress | completed>
+```
+
+## Task HLD format
+
+```markdown
+# <Task name> - High Level Design
+
+## Problem
+
+<What problem does this solve>
+
+## Solution
+
+<High-level approach>
+
+## Scope
+
+- <What's included>
+- <What's excluded>
+```
+
+## Task LLD format
+
+```markdown
+# <Task name> - Low Level Design
+
+## Implementation
+
+<Detailed technical approach>
+
+## Files to modify
+
+- `path/to/file.ts`: <changes>
+
+## Testing
+
+<How to verify the implementation>
+```

package/dist/templates/.openfleet/stories/unassigned/README.md

@@ -0,0 +1,40 @@
+# Unassigned Tasks
+
+Tasks that don't belong to a specific story.
+
+## Structure
+
+```
+unassigned/
+├── README.md                    # This file
+└── MM-DD_<task-name>/
+    ├── HLD.md                   # High-level design (optional for small tasks)
+    └── LLD.md                   # Low-level design (optional for small tasks)
+```
+
+## Usage
+
+Place standalone tasks here that are:
+
+- Quick fixes
+- One-off requests
+- Not part of a larger initiative
+
+Move to a story directory when they become part of a larger effort.
+
+## When to skip HLD/LLD
+
+For trivial tasks (< 1 hour of work), a single `notes.md` is sufficient:
+
+```markdown
+# <Task name>
+
+## What
+
+<Brief description>
+
+## Changes
+
+- <Change 1>
+- <Change 2>
+```

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "openfleet",
+  "version": "0.1.0",
+  "description": "SPAR framework agents + infinite context for OpenCode",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "opencode",
+    "plugin"
+  ],
+  "author": "Scott Susanto",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scottsus/openfleet.git"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean && cp -r src/templates dist/",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*": "prettier --write --ignore-unknown"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.2",
+    "@opencode-ai/plugin": "^1.0.191",
+    "@opencode-ai/sdk": "^1.0.191"
+  },
+  "devDependencies": {
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
+    "@types/node": "^22",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}