opcrew 0.1.6 → 0.1.7

package/dist/templates/logbook.template.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "./logbook.schema.json",
+  "voyage": { "status": "idle" },
+  "missions": [],
+  "decisions": [],
+  "blockers": [],
+  "notes": []
+}

package/dist/templates/templates/knowledge/README.md

@@ -0,0 +1,67 @@
+# Knowledge Base Conventions
+
+This folder is the **canonical, human-readable source of truth** for project context. Agents must read relevant files before acting and update them when decisions or constraints change.
+
+## Structure
+
+- `decisions/` — Architecture Decision Records (ADRs)
+- `runbooks/` — Operational procedures and recurring workflows
+- `glossary.md` — Terms, abbreviations, and canonical definitions
+- `project-map.md` — High-level module map, ownership boundaries, and key entry points
+
+## Rules of Engagement
+
+1. **Read first:** Check `project-map.md`, `glossary.md`, and any related ADRs before planning or execution.
+2. **Write when you decide:** Any non-trivial decision that changes direction, constraints, or approach must be captured as an ADR.
+3. **Keep it small and explicit:** Prefer concise entries with clear rationale and consequences.
+4. **No hidden knowledge:** If it matters for future work, it belongs here.
+5. **Git is the source of truth:** Do not store canonical decisions in databases; this folder is the canonical record.
+
+## ADR Template
+
+Create a new file in `decisions/` using the next sequence number:
+
+```text
+YYYYMMDD-###-short-title.md
+```
+
+Include the following sections:
+
+```markdown
+# Title
+
+## Status
+Accepted | Superseded | Deprecated
+
+## Context
+What problem are we solving? What constraints apply?
+
+## Decision
+What did we decide?
+
+## Consequences
+What tradeoffs or follow-up work does this create?
+```
+
+## Runbook Template
+
+Create a new file in `runbooks/` using:
+
+```text
+topic-short-title.md
+```
+
+```markdown
+# Title
+
+## Purpose
+
+## Preconditions
+
+## Steps
+1.
+
+## Verification
+
+## Rollback
+```

package/dist/templates/templates/knowledge/glossary.md

@@ -0,0 +1,10 @@
+# Glossary
+
+## ADR (Architecture Decision Record)
+A short, structured document that records a significant architectural or process decision.
+
+## Logbook
+The mission log that captures decisions, risks, task status, and verification evidence.
+
+## Mission
+A unit of work defined by the Captain, executed by crew agents.

package/dist/templates/templates/knowledge/project-map.md

@@ -0,0 +1,13 @@
+# Project Map
+
+## Purpose
+High-level map of key modules, entry points, and ownership boundaries.
+
+## Modules
+(Add your project modules here)
+
+## Entry Points
+(Add your entry points here)
+
+## Conventions
+(Add your project conventions here)

package/dist/templates/templates/logbook.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Logbook",
+  "description": "OpenCrew logbook for tracking voyage status, missions, decisions, and blockers",
+  "type": "object",
+  "required": ["voyage", "missions", "decisions", "blockers", "notes"],
+  "properties": {
+    "voyage": {
+      "type": "object",
+      "description": "Current voyage/session information",
+      "properties": {
+        "id": { "type": "string" },
+        "started": { "type": "string", "format": "date-time" },
+        "status": { "type": "string", "enum": ["idle", "active", "blocked", "completed"] }
+      }
+    },
+    "missions": {
+      "type": "array",
+      "description": "List of missions undertaken",
+      "items": {
+        "type": "object",
+        "required": ["id", "intent", "status"],
+        "properties": {
+          "id": { "type": "string" },
+          "intent": { "type": "string" },
+          "assigned_to": { "type": "string" },
+          "status": { "type": "string", "enum": ["pending", "in_progress", "completed", "blocked"] },
+          "started": { "type": "string", "format": "date-time" },
+          "completed": { "type": "string", "format": "date-time" },
+          "outcome": { "type": "string" }
+        }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "description": "Key decisions made during the voyage",
+      "items": {
+        "type": "object",
+        "required": ["id", "decision", "rationale", "made_by"],
+        "properties": {
+          "id": { "type": "string" },
+          "decision": { "type": "string" },
+          "rationale": { "type": "string" },
+          "alternatives": { "type": "array", "items": { "type": "string" } },
+          "made_by": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" }
+        }
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "description": "Current blockers impeding progress",
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "severity"],
+        "properties": {
+          "id": { "type": "string" },
+          "description": { "type": "string" },
+          "severity": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+          "raised_by": { "type": "string" },
+          "raised_at": { "type": "string", "format": "date-time" },
+          "resolved": { "type": "boolean" },
+          "resolution": { "type": "string" }
+        }
+      }
+    },
+    "notes": {
+      "type": "array",
+      "description": "General notes and observations",
+      "items": {
+        "type": "object",
+        "required": ["id", "content"],
+        "properties": {
+          "id": { "type": "string" },
+          "content": { "type": "string" },
+          "author": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" }
+        }
+      }
+    }
+  }
+}

package/dist/templates/templates/logbook.template.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "./logbook.schema.json",
+  "voyage": { "status": "idle" },
+  "missions": [],
+  "decisions": [],
+  "blockers": [],
+  "notes": []
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opcrew",
   "description": "OpenCrew agents and OpenCode plugin",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "main": "./dist/opencode-plugin.js",
   "module": "./dist/opencode-plugin.js",
   "type": "module",
@@ -29,10 +29,11 @@
     "opcrew": "./dist/cli.js"
   },
   "scripts": {
-    "build": "bun run build:plugin && bun run build:cli && bun run build:skills",
+    "build": "bun run build:plugin && bun run build:cli && bun run build:skills && bun run build:templates",
     "build:plugin": "bun build src/opencode-plugin.ts --outdir dist --target bun",
     "build:cli": "bun build src/cli/index.ts --outfile dist/cli.js --target bun",
     "build:skills": "cp -r src/skills dist/skills",
+    "build:templates": "cp -r src/templates dist/templates",
     "prepack": "bun run build",
     "test": "bun test",
     "build:types": "bunx tsc -p tsconfig.build.json"