lobsidian 1.0.0

package/embedded/procedures/review-cycle.md

@@ -0,0 +1,47 @@
+# Review Cycle
+
+Load this procedure when a decision's `review_date` has been reached (`review_date <= today AND status: active`).
+
+## Steps
+
+### 1. Present the Review
+
+Set decision `status: under-review`. Present conversationally:
+
+*"It's been [N weeks] since we decided to [proposal]. Here's what happened: [outcomes from linked tasks]."*
+
+### 2. Seek Feedback
+
+*"Is there anything about this that isn't working, or something we should change?"*
+
+### 3. Act on Response
+
+**Still valid, meeting criteria:**
+- Set `status: active`
+- Advance `review_date`: `today + review_frequency` (from current date, not original review_date)
+- Log: `"review confirmed, next review YYYY-MM-DD"`
+
+**Still valid, not meeting criteria:**
+- Propose amendments (minor: increment `version`) or supersession (substantive changes)
+- Set `status: active` with advanced `review_date`
+- Create new tasks if needed
+
+**No longer needed:**
+- Set decision `status: retired`
+- Check if parent motive should be updated
+- Archive the decision
+
+### Escalation
+
+Decisions overdue by 2x their `review_frequency` period: create a motive documenting the overdue review. This ensures overdue reviews are not silently ignored.
+
+### Review Date Calculation
+
+| Frequency | Advance by |
+|-----------|-----------|
+| weekly | 7 days |
+| biweekly | 14 days |
+| monthly | 1 month |
+| quarterly | 3 months |
+| biannually | 6 months |
+| annually | 1 year |

package/embedded/start-here.md

@@ -0,0 +1,60 @@
+# Welcome to Your Lobsidian Vault
+
+Lobsidian is a structured knowledge system that helps you and your AI agents organize work, make decisions, and track what matters.
+
+## How It Works
+
+Everything traces a chain: a **motive** (why something matters) produces a **decision** (what to do about it), which breaks into **tasks** (concrete work). Decisions carry a review date, closing the loop.
+
+## Folder Structure
+
+| Folder | What goes here | Naming |
+|--------|---------------|--------|
+| `Motives/` | Problems to solve, opportunities to seize | `YYYY-MM-DD-slug.md` |
+| `Decisions/` | What was decided and why | `YYYY-MM-DD-slug.md` |
+| `Tasks/` | Concrete work items | `YYYY-MM-DD-slug.md` |
+| `Knowledge/` | Reference material, notes, insights | `topic-slug.md` |
+| `Journal/` | Daily notes, activity logs | `YYYY-MM-DD.md` |
+| `Inbox/` | Anything unprocessed | any name |
+| `Archive/` | Completed or retired items | mirrors source folders |
+| `_lobsidian/` | System files (do not edit) | managed by protocol |
+
+## The Motive-Decision-Task Chain
+
+Check the example files to see a complete chain in action:
+
+1. **Motive**: `Motives/2026-01-01-example-website-performance.md` -- why website speed matters
+2. **Decision**: `Decisions/2026-01-01-example-cdn-caching.md` -- what to do about it
+3. **Task**: `Tasks/2026-01-01-example-configure-cloudfront.md` -- the concrete work
+
+These examples are disposable -- delete them whenever you like.
+
+## Getting Started
+
+### With an AI Agent
+
+Your agent reads `_lobsidian/AGENT.md` on startup and knows how to operate. Just tell it about a problem or goal, and it will guide you through creating motives, decisions, and tasks.
+
+Try: *"Our website is slow and we're losing visitors."*
+
+The agent will ask clarifying questions, create a motive, propose a decision, and break it into tasks.
+
+### Without an Agent
+
+1. Create a file in `Motives/` describing a problem or opportunity (use the template in `_lobsidian/templates/motive.md`)
+2. When you decide what to do, create a file in `Decisions/` linking to the motive
+3. Break the decision into tasks in `Tasks/`
+4. Review decisions when their `review_date` arrives
+
+## Key Concepts
+
+- **Frontmatter is the API** -- the YAML block at the top of each file is what matters. Folders are for human convenience.
+- **Nothing is deleted** -- completed items move to `Archive/`. Wiki-links still resolve.
+- **Decisions need consent** -- decisions go through `draft` -> `proposed` -> `active`. The `proposed` stage is a checkpoint for review.
+- **Review dates close the loop** -- every decision has a `review_date`. When it arrives, revisit whether the decision is still working.
+
+## Need Help?
+
+- Run `lobsidian validate` to check your vault for issues
+- Templates for each file type are in `_lobsidian/templates/`
+- The full protocol spec is at [lobsidian.dev](https://lobsidian.dev)

package/embedded/templates/decision.md

@@ -0,0 +1,29 @@
+---
+# Required
+type: decision
+title: ""
+status: draft                         # draft | proposed | active | under-review | superseded | retired
+motive: "[[motive-filename]]"         # link to parent motive
+version: 1
+proposal: >
+  What we will do and how.
+success_criteria:
+  - "Measurable criterion 1"
+review_date: YYYY-MM-DD
+created: YYYY-MM-DD
+source: agent                         # agent | human
+created_by: ""                        # agent-name | "human"
+
+# Optional
+responsible: null                     # agent-name
+review_frequency: quarterly           # weekly | biweekly | monthly | quarterly | biannually | annually
+superseded_by: null                   # "[[new-decision]]" when superseded
+concerns: []
+objections_considered: []
+confidence: null                      # high | medium | low
+updated: null
+tags: []
+log: []
+---
+
+<!-- Body: rationale, alternatives considered, implementation notes -->

package/embedded/templates/domain.md

@@ -0,0 +1,46 @@
+---
+type: domain
+name: ""
+purpose: >
+  Why this domain exists.
+motive: null                          # "[[primary-motive]]"
+motives: []                           # list of "[[motive]]" wiki-links
+
+# Scope
+includes:
+  - "Knowledge/"
+  - "Motives/"
+  - "Decisions/"
+  - "Tasks/"
+excludes:
+  - "Journal/"
+  - "_lobsidian/"
+  - "*.env"
+
+# Authority
+filled_by: null                       # agent-name | human-name
+autonomous_decisions:
+  - "Create and edit files within included paths"
+  - "Claim tasks whose deliverable location is within scope"
+  - "Create motive files for problems observed within scope"
+requires_consent:
+  - "Delete any file"
+  - "Modify domain definitions"
+  - "Create decisions"
+  - "Move files outside domain scope"
+
+# Constraints
+wip_limit: 3
+max_timebox_minutes: 120
+
+# Monitoring
+key_metrics: []
+dependencies: []
+
+# Review
+review_date: YYYY-MM-DD
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+---
+
+<!-- Body: domain context, boundaries, notes -->

package/embedded/templates/log.md

@@ -0,0 +1,12 @@
+---
+type: log
+subtype: daily                        # daily | activity | meeting | reflection
+date: YYYY-MM-DD
+created_by: ""                        # agent-name | "human"
+source: human                         # agent | human
+motive: null                          # "[[motive-filename]]"
+tags: []
+confidence: null                      # high | medium | low
+---
+
+<!-- Body: log content -->

package/embedded/templates/motive.md

@@ -0,0 +1,25 @@
+---
+# Required
+type: motive
+title: ""
+status: open                          # open | addressed | obsolete
+situation: >
+  Objective description of what is currently happening.
+need: >
+  What must change or be established to address this.
+created: YYYY-MM-DD
+source: agent                         # agent | human | bootstrap
+created_by: ""                        # agent-name | "human"
+
+# Optional
+parent: null                          # "[[parent-motive]]" for sub-motives
+bootstrapped: false                   # true only for bootstrap-created motives
+effect: >
+  Why this situation matters.
+confidence: null                      # high | medium | low (required if source: agent)
+updated: null
+tags: []
+log: []
+---
+
+<!-- Body: additional context, evidence, related links -->

package/embedded/templates/note.md

@@ -0,0 +1,13 @@
+---
+type: note
+title: ""
+source: human                         # agent | human | bootstrap
+created_by: ""                        # agent-name | "human"
+created: YYYY-MM-DD
+topics: []
+confidence: null                      # high | medium | low
+updated: null
+tags: []
+---
+
+<!-- Body: knowledge content -->

package/embedded/templates/task.md

@@ -0,0 +1,39 @@
+---
+# Required
+type: task
+title: ""
+status: pending                       # pending | claimed | in-progress | blocked | done | cancelled
+created: YYYY-MM-DD
+source: agent                         # agent | human
+created_by: ""                        # agent-name | "human"
+
+# Optional -- linking
+motive: null                          # "[[motive-filename]]"
+decision: null                        # "[[decision-filename]]"
+
+# Assignment (Pull System)
+assignee: null                        # agent-name
+priority: 5                           # positive integer, lower = higher priority
+claimed_at: null                      # ISO 8601 timestamp
+
+# Deliverable specification
+deliverable_format: null              # e.g. "markdown file"
+deliverable_location: null            # e.g. "Knowledge/"
+deliverable_criteria: []
+
+# Timebox
+timebox_minutes: null
+due_date: null                        # YYYY-MM-DD
+
+# Outcome (filled on completion)
+outcome: null                         # required when status: done
+completed_at: null                    # required when status: done, ISO 8601
+
+# Metadata
+confidence: null                      # high | medium | low
+updated: null
+tags: []
+log: []
+---
+
+<!-- Body: implementation notes, progress updates -->

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "lobsidian",
+  "version": "1.0.0",
+  "description": "Structured accountability for AI agents — markdown-based knowledge protocol",
+  "type": "module",
+  "bin": {
+    "lobsidian": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "embedded/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "accountability",
+    "markdown",
+    "knowledge-management",
+    "obsidian"
+  ],
+  "author": "can.nuri",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cannuri/lobsidian.git"
+  },
+  "homepage": "https://github.com/cannuri/lobsidian#readme",
+  "bugs": {
+    "url": "https://github.com/cannuri/lobsidian/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}