dreamcontext 0.5.0

package/dist/templates/council-final-report.md

@@ -0,0 +1,34 @@
+---
+debate_id: "{{ID}}"
+topic: "{{TOPIC}}"
+synthesized_at: "{{DATE}}"
+personas: {{PERSONAS}}
+rounds: {{ROUNDS}}
+---
+
+## Verdict
+
+(The decision in one or two sentences.)
+
+## Why
+
+(Every WHY traced. One bullet per reason, 1–2 sentences human prose. Source tag
+as a trailing italic line — never mid-sentence parentheticals. If a whole section
+shares the same source mix, write `*Consensus: slug R1, slug R2*` once at the
+section top instead of repeating per bullet.)
+
+## What was debated
+
+(Ideas, pushback, position shifts across rounds. Name personas; cite round numbers.)
+
+## Minority views
+
+(Positions that did not win but deserve recording — especially risks the majority dismissed.)
+
+## Open risks
+
+(What could still go wrong if the verdict is acted on. Flag concrete monitoring or mitigations.)
+
+## Appendix: per-agent per-round summaries
+
+(Executive summaries only — one per persona per round.)

package/dist/templates/council-persona.md

@@ -0,0 +1,10 @@
+---
+name: "{{SLUG}}"
+model: "{{MODEL}}"
+aspects: {{ASPECTS}}
+round_entries: 0
+---
+
+## Persona
+
+{{PERSONA_BODY}}

package/dist/templates/council-report.md

@@ -0,0 +1,6 @@
+---
+persona: "{{SLUG}}"
+rounds_completed: 0
+---
+
+<!-- Each round is appended above previous rounds (LIFO). Required subsections per round: Executive Summary, Position, Reasoning, Reactions to peers, Open questions. -->

package/dist/templates/feature.md

@@ -0,0 +1,38 @@
+---
+id: "{{ID}}"
+status: "planning"
+created: "{{DATE}}"
+updated: "{{DATE}}"
+released_version: null
+tags: []
+related_tasks: []
+---
+
+## Why
+
+{{WHY}}
+
+## User Stories
+
+- [ ] As a [user], I want [action] so that [outcome]
+
+## Acceptance Criteria
+
+- (Specific, testable conditions for this feature to be complete)
+
+## Constraints & Decisions
+<!-- LIFO: newest decision at top -->
+
+## Technical Details
+
+(How this feature is wired. Key files, services, dependencies, flows.)
+
+## Notes
+
+(Edge cases, open questions, future considerations.)
+
+## Changelog
+<!-- LIFO: newest entry at top -->
+
+### {{DATE}} - Created
+- Feature PRD created.

package/dist/templates/init/0.soul.md

@@ -0,0 +1,33 @@
+---
+name: "{{PROJECT_NAME}}"
+type: soul
+updated: "{{DATE}}"
+---
+
+## Project Identity
+
+{{PROJECT_DESCRIPTION}}
+
+## Target User
+
+{{TARGET_USER}}
+
+## Current Priority
+
+{{PRIORITY}}
+
+## Core Principles
+
+- (Add your project's guiding principles here)
+
+## Constraints
+
+- (Add known constraints, limitations, or non-negotiables)
+
+## Agent Behaviors & Rules
+
+- (Project-specific behaviors: "Always run tests before committing", "Use X pattern for Y")
+
+## Warnings & Non-Negotiables
+
+- (Things that must never happen: "Never expose API keys", "Never delete production data")

package/dist/templates/init/1.user.md

@@ -0,0 +1,29 @@
+---
+name: user-preferences
+type: user
+updated: "{{DATE}}"
+---
+
+## User Preferences
+
+- (Decision-making patterns, priorities, review preferences)
+
+## Communication Style
+
+- (How the user prefers to interact: concise? detailed? technical?)
+
+## Project Details
+
+- (Key project facts: repo structure, deployment targets, environments)
+
+## Project Rules
+
+- (Naming conventions, branching strategy, PR process, code style)
+
+## Skills & Capabilities
+
+- (Tools, frameworks, and technologies the user/team is proficient with)
+
+## Workflow Notes
+
+- (How work flows: review cycles, approval processes, deployment steps)

package/dist/templates/init/2.memory.md

@@ -0,0 +1,21 @@
+---
+name: active-decisions
+type: memory
+updated: "{{DATE}}"
+---
+
+## Active Memory
+
+> Ship events live in `core/CHANGELOG.json`. Use `dreamcontext memory recall "<query>"` to find prior decisions, sessions, or shipped changes.
+
+## Technical Decisions
+
+<!-- Long-lived architectural decisions referenced repeatedly. Granular implementation decisions belong in `knowledge/`. -->
+
+- (Key technical choices and their rationale)
+
+## Known Issues
+
+<!-- Current bugs, tech debt, workarounds. Resolve or move to knowledge/ once stale. -->
+
+- (Open issues and their status)

package/dist/templates/init/3.style_guide_and_branding.md

@@ -0,0 +1,18 @@
+---
+name: style-guide
+type: style
+summary: ""
+updated: "{{DATE}}"
+---
+
+## Branding
+
+- (Colors, fonts, logo guidelines)
+
+## UI/UX Conventions
+
+- (Component patterns, spacing, responsive behavior)
+
+## Voice & Tone
+
+- (Writing style for user-facing content)

package/dist/templates/init/4.tech_stack.md

@@ -0,0 +1,22 @@
+---
+name: tech-stack
+type: tech
+summary: ""
+updated: "{{DATE}}"
+---
+
+## Tech Stack
+
+{{TECH_STACK}}
+
+## Architecture Overview
+
+- (High-level architecture: monolith, microservices, serverless, etc.)
+
+## Key Dependencies
+
+- (Critical libraries, frameworks, and their versions)
+
+## Infrastructure
+
+- (Hosting, CI/CD, databases, external services)

package/dist/templates/init/CHANGELOG.json

@@ -0,0 +1 @@
+[]

package/dist/templates/init/RELEASES.json

@@ -0,0 +1 @@
+[]

package/dist/templates/init/data-structures/default.md

@@ -0,0 +1,35 @@
+---
+name: {{PRODUCT_NAME}}
+description: Data structures for {{PRODUCT_NAME}}
+type: data-structures
+product: {{PRODUCT_NAME}}
+updated: {{DATE}}
+---
+
+# Data Structures — {{PRODUCT_NAME}}
+
+Document this product's database schema, key models, and API contracts here. This file is the source of truth for data shapes.
+
+## Conventions
+
+- One `data-structures/<product>.md` file per product in a monorepo. `default.md` is the single-product fallback.
+- Sleep-state applies the **single-observation gate** to this file: a single session that adds, removes, or changes a schema MUST be reflected here in the same sleep cycle. No pattern repetition required.
+- Tasks MAY include `product: <name>` in frontmatter to route data-structure observations to the matching product file.
+
+## Schema
+
+<!-- Example:
+
+```sql
+CREATE TABLE users (
+  id UUID PRIMARY KEY,
+  email VARCHAR(255) NOT NULL UNIQUE,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+```
+
+Or document models in any format that matches the stack — TypeScript interfaces, Prisma schema, Pydantic models, GraphQL SDL. -->
+
+## API Contracts
+
+<!-- Document request/response shapes, route handlers, and external API integrations relevant to this product. -->

package/dist/templates/knowledge.md

@@ -0,0 +1,10 @@
+---
+id: "{{ID}}"
+name: "{{NAME}}"
+description: "{{DESCRIPTION}}"
+tags: []
+pinned: false
+date: "{{DATE}}"
+---
+
+{{CONTENT}}

package/dist/templates/obsidian/app.json

@@ -0,0 +1,15 @@
+{
+  "newFileLocation": "folder",
+  "newFileFolderPath": "inbox",
+  "attachmentFolderPath": "./",
+  "alwaysUpdateLinks": true,
+  "useMarkdownLinks": false,
+  "showLineNumber": true,
+  "foldHeading": true,
+  "foldIndent": true,
+  "showFrontmatter": true,
+  "tabSize": 2,
+  "readableLineLength": true,
+  "strictLineBreaks": false,
+  "promptDelete": true
+}

package/dist/templates/obsidian/appearance.json

@@ -0,0 +1,4 @@
+{
+  "accentColor": "#4fb3e6",
+  "theme": "obsidian"
+}

package/dist/templates/obsidian/graph.json

@@ -0,0 +1,58 @@
+{
+  "collapse-filter": false,
+  "search": "",
+  "showTags": true,
+  "showAttachments": false,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": false,
+  "colorGroups": [
+    {
+      "query": "path:core/features",
+      "color": {
+        "a": 1,
+        "rgb": 1096577
+      }
+    },
+    {
+      "query": "path:core",
+      "color": {
+        "a": 1,
+        "rgb": 5223910
+      }
+    },
+    {
+      "query": "path:knowledge",
+      "color": {
+        "a": 1,
+        "rgb": 10980858
+      }
+    },
+    {
+      "query": "path:state",
+      "color": {
+        "a": 1,
+        "rgb": 16097803
+      }
+    },
+    {
+      "query": "path:inbox",
+      "color": {
+        "a": 1,
+        "rgb": 10265007
+      }
+    }
+  ],
+  "collapse-display": false,
+  "showArrow": true,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 1.2,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": false,
+  "centerStrength": 0.5,
+  "repelStrength": 12,
+  "linkStrength": 1,
+  "linkDistance": 250,
+  "scale": 1,
+  "close": false
+}

package/dist/templates/task.md

@@ -0,0 +1,70 @@
+---
+id: "{{ID}}"
+name: "{{NAME}}"
+description: "{{DESCRIPTION}}"
+priority: "{{PRIORITY}}"
+urgency: "{{URGENCY}}"
+status: "{{STATUS}}"
+created_at: "{{DATE}}"
+updated_at: "{{DATE}}"
+tags: {{TAGS}}
+parent_task: null
+related_feature: null
+version: {{VERSION}}
+# RICE prioritization (optional). Uncomment + fill to enable Scatter view + RICE sort.
+# rice:
+#   reach: 5         # integer 1–10
+#   impact: 3        # integer 1–5
+#   confidence: 75   # one of 25, 50, 75, 100
+#   effort: 2        # weeks, > 0 and ≤ 52 (0.5 step OK)
+#   score: null      # derived server-side; leave null
+---
+
+## Workflow
+<!-- The shape of this task at a glance. One node per acceptance criterion, grouped under milestone subgraphs. Update node classes as work progresses: `:::done` (green), `:::active` (amber), `:::todo` (gray), `:::blocked` (red). Run `dreamcontext tasks doctor` to verify sync. -->
+
+```mermaid
+flowchart TD
+  subgraph M1 ["Milestone 1 — rename me"]
+    A1[First criterion]:::todo
+  end
+
+  classDef done fill:#86efac,stroke:#15803d,color:#052e16
+  classDef active fill:#fde68a,stroke:#b45309,color:#451a03
+  classDef todo fill:#e5e7eb,stroke:#6b7280,color:#111827
+  classDef blocked fill:#fecaca,stroke:#b91c1c,color:#450a0a
+```
+
+## Why
+<!-- What problem does this solve? What breaks if we don't do it? Be concrete — name the user, the friction, the cost. One paragraph beats five bullets. -->
+
+{{WHY}}
+
+## User Stories
+<!-- Who benefits, what they can do, why it matters. Format: As a <role>, I can <action>, so that <outcome>. Tick the box when the story is demonstrably true in the running system. -->
+
+- [ ] As a [role], I can [action], so that [outcome]
+
+## Acceptance Criteria
+<!-- The contract. Each line is testable, observable, and gets a node in the Workflow flowchart above. Tick `[x]` AND flip the node to `:::done` in the same edit. -->
+
+- [ ] First criterion (matches node A1 in Workflow)
+
+## Constraints & Decisions
+<!-- LIFO: newest decision at top. Format: **[YYYY-MM-DD]** Decision + one-line rationale. Capture trade-offs, not just outcomes — future you needs the "why". -->
+
+## Technical Details
+<!-- Where the work lives. Files to touch, services involved, key functions to reuse. Update this in place when the approach changes — don't append; the body is current truth, the changelog is history. -->
+
+(Key files, services, dependencies, implementation approach.)
+
+## Notes
+<!-- Loose ends. Edge cases, open questions, things to verify, ideas for later. -->
+
+(Working notes, edge cases, open questions.)
+
+## Changelog
+<!-- LIFO: newest entry at top. Auto-prepended by `dreamcontext tasks log`. Each entry is a session-shaped breadcrumb — what shipped, what was decided, where you stopped. -->
+
+### {{DATE}} - Created
+- Task created.

package/install.sh

@@ -0,0 +1,73 @@
+#!/bin/sh
+# dreamcontext install script
+# Review this script before piping it to sh: https://github.com/meanllbrl/dreamcontext
+set -e
+
+say() {
+  printf '%s\n' "$*"
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+check_node() {
+  if ! command -v node > /dev/null 2>&1; then
+    die "Node.js is not installed. Install it from https://nodejs.org (v18 or later required), then re-run this script."
+  fi
+  if ! command -v npm > /dev/null 2>&1; then
+    die "npm is not installed. Install Node.js (which includes npm) from https://nodejs.org, then re-run this script."
+  fi
+  node_major=$(node -e "process.stdout.write(String(process.versions.node.split('.')[0]))")
+  if [ "$node_major" -lt 18 ]; then
+    die "Node.js v${node_major} is too old. dreamcontext requires Node.js >= 18. Upgrade at https://nodejs.org, then re-run this script."
+  fi
+  say "Node.js $(node --version) detected."
+}
+
+install_cli() {
+  say "Installing dreamcontext..."
+  # Installs the published dreamcontext CLI from npm. Review this script before piping it to sh.
+  npm install -g dreamcontext@latest
+}
+
+verify() {
+  if ! dreamcontext --version > /dev/null 2>&1; then
+    die "Installation verification failed: 'dreamcontext --version' did not succeed. Check the npm install output above for errors."
+  fi
+  installed_version=$(dreamcontext --version 2>/dev/null || true)
+  say "dreamcontext ${installed_version} installed successfully."
+}
+
+maybe_setup() {
+  if [ -d "_dream_context" ]; then
+    say "Existing _dream_context/ detected. Running 'dreamcontext update'..."
+    dreamcontext update
+    return
+  fi
+
+  if [ -n "${DREAMCONTEXT_INSTALL_NO_SETUP:-}" ]; then
+    say "DREAMCONTEXT_INSTALL_NO_SETUP is set. Skipping setup."
+    say "Run \`dreamcontext setup\` to finish."
+    exit 0
+  fi
+
+  if [ -t 0 ]; then
+    say "Running 'dreamcontext setup' to initialize your project..."
+    dreamcontext setup
+  else
+    say "Run \`dreamcontext setup\` to finish."
+    exit 0
+  fi
+}
+
+main() {
+  say "==> dreamcontext installer"
+  check_node
+  install_cli
+  verify
+  maybe_setup
+}
+
+main

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "dreamcontext",
+  "version": "0.5.0",
+  "description": "dreamcontext — the persistent brain for your AI agents. Remembers what you built, knows how your project works.",
+  "type": "module",
+  "bin": {
+    "dreamcontext": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "skill-packs",
+    "agents",
+    "README.md",
+    "LICENSE",
+    "install.sh"
+  ],
+  "scripts": {
+    "build:dashboard": "cd dashboard && npm run build",
+    "build:cli": "tsup",
+    "build": "npm run build:dashboard && npm run build:cli",
+    "dev": "tsup --watch",
+    "dev:dashboard": "cd dashboard && npm run dev",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "context",
+    "memory",
+    "brain",
+    "cli",
+    "claude",
+    "gemini",
+    "llm"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
+    "boxen": "^8.0.1",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "fast-glob": "^3.3.3",
+    "gray-matter": "^4.0.3",
+    "nanoid": "^5.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "sharp": "^0.34.5",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.6"
+  }
+}