handover to @parlakisik.

Signed-off-by: Jose Alekhinne <jose@ctx.ist>

Author: josealekhine

.context/CONSTITUTION.md

@@ -14,6 +14,56 @@ DO NOT UPDATE FOR:
 
 These rules are INVIOLABLE. If a task requires violating these, the task is wrong.
 
+## Completion Over Motion
+
+Work is only complete when it is **fully done**, not when progress has been made.
+
+- The requested outcome must be delivered end-to-end.
+- Partial progress is not completion.
+- No half measures.
+
+Do not:
+- Leave broken or inconsistent states
+- Deliver work that requires the user to "finish it later"
+
+If you start something, you own it, you finish it.
+
+---
+
+## No Excuse Generation
+
+**Never default to deferral.**
+
+Your goal is to satisfy the user's intent, not to complete a narrow
+interpretation of the task.
+
+Do not justify incomplete work with statements like:
+
+- "Let's continue this later"
+- "This is out of scope"
+- "I can create a follow-up task"
+- "This will take too long"
+- "Another system caused this"
+- "This part is not mine"
+- "We are running out of context window"
+
+Constraints may exist, but they do not excuse incomplete delivery.
+
+- External systems, prior code, or other agents are not valid excuses
+- Inconsistencies must be resolved, not explained away
+
+---
+
+## No Broken Windows
+
+Leave the system in a better state than you found it.
+
+- Fix obvious issues when encountered
+- Do not introduce temporary hacks without resolving them
+- Do not normalize degraded quality
+
+---
+
 ## Security Invariants
 
 - [ ] Never commit secrets, tokens, API keys, or credentials

.context/TASKS.md

@@ -0,0 +1,73 @@
+---
+#   /    ctx:                         https://ctx.ist
+# ,'`./    do you remember?
+# `.,'\
+#   \    Copyright 2026-present Context contributors.
+#                 SPDX-License-Identifier: Apache-2.0
+
+title: Change
+icon: lucide/diff
+---
+
+## `ctx change`
+
+Show what changed in context files and code since your last
+session.
+
+Automatically detects the previous session boundary from state
+markers or event log. Useful at session start to quickly see
+what moved while you were away.
+
+```bash
+ctx change [flags]
+```
+
+**Flags**:
+
+| Flag      | Description                                             |
+|-----------|---------------------------------------------------------|
+| `--since` | Time reference: duration (`24h`) or date (`2026-03-01`) |
+
+**Reference time detection** (priority order):
+
+1. `--since` flag (duration, date, or RFC3339 timestamp)
+2. `ctx-loaded-*` marker files in `.context/state/` (second most recent)
+3. Last `context-load-gate` event from `.context/state/events.jsonl`
+4. Fallback: 24 hours ago
+
+**Examples**:
+
+```bash
+# Auto-detect last session, show what changed
+ctx change
+
+# Changes in the last 48 hours
+ctx change --since 48h
+
+# Changes since a specific date
+ctx change --since 2026-03-10
+```
+
+**Output**:
+
+```
+## Changes Since Last Session
+
+**Reference point**: 6 hours ago
+
+### Context File Changes
+- `TASKS.md` - modified 2026-03-12 14:30
+- `DECISIONS.md` - modified 2026-03-12 09:15
+
+### Code Changes
+- **12 commits** since reference point
+- **Latest**: Fix journal enrichment ordering
+- **Directories touched**: internal, docs, specs
+- **Authors**: jose, claude
+```
+
+Context file changes are detected by filesystem mtime (works
+without git). Code changes use `git log --since` (empty when
+not in a git repo).
+
+**See also**: [Reviewing Session Changes](../recipes/session-changes.md).

docs/cli/change.md

@@ -0,0 +1,58 @@
+---
+#   /    ctx:                         https://ctx.ist
+# ,'`./    do you remember?
+# `.,'\
+#   \    Copyright 2026-present Context contributors.
+#                 SPDX-License-Identifier: Apache-2.0
+
+title: Completion
+icon: lucide/keyboard
+---
+
+## `ctx completion`
+
+Generate shell autocompletion scripts.
+
+```bash
+ctx completion <shell>
+```
+
+### Subcommands
+
+| Shell        | Command                     |
+|--------------|-----------------------------|
+| `bash`       | `ctx completion bash`       |
+| `zsh`        | `ctx completion zsh`        |
+| `fish`       | `ctx completion fish`       |
+| `powershell` | `ctx completion powershell` |
+
+### Installation
+
+=== "Bash"
+
+    ```bash
+    # Add to ~/.bashrc
+    source <(ctx completion bash)
+    ```
+
+=== "Zsh"
+
+    ```bash
+    # Add to ~/.zshrc
+    source <(ctx completion zsh)
+    ```
+
+=== "Fish"
+
+    ```bash
+    ctx completion fish | source
+    # Or save to completions directory
+    ctx completion fish > ~/.config/fish/completions/ctx.fish
+    ```
+
+=== "PowerShell"
+
+    ```powershell
+    # Add to your PowerShell profile
+    ctx completion powershell | Out-String | Invoke-Expression
+    ```

docs/cli/completion.md

@@ -11,14 +11,34 @@ icon: lucide/link
 
 ## `ctx connect`
 
-Connect to a shared context hub for cross-project knowledge sharing.
-Projects publish decisions, learnings, and conventions to a centralized
-hub; other projects receive them alongside local context.
+Connect a project to a `ctx` Hub for cross-project
+knowledge sharing. Projects publish decisions, learnings,
+conventions, and tasks to a hub; other subscribed projects receive
+them alongside local context.
+
+!!! tip "New to the hub?"
+    Start with the
+    [`ctx` Hub overview](../recipes/hub-overview.md) for
+    the mental model (what the hub is, who it's for, what it is
+    **not**), then walk through
+    [Getting Started](../recipes/hub-getting-started.md).
+    This page is a command reference, not an introduction.
+
+**The unit of identity is a project, not a user.** Registering a
+directory with `ctx connect register` binds a per-project client
+token in `.context/.connect.enc`. Two developers on the same
+project either share that file over a trusted channel, or each
+register under a different project name.
+
+**Only structured entries flow through the hub** — `decision`,
+`learning`, `convention`, `task`. Session journals, scratchpad
+contents, and other local state stay on the machine that created
+them.
 
 ### `ctx connect register`
 
-One-time registration with a shared hub. Requires the hub address and
-admin token (printed by `ctx serve --shared` on first run).
+One-time registration with a hub. Requires the hub address and
+admin token (printed by `ctx hub start` on first run).
 
 ```bash
 ctx connect register localhost:9900 --token ctx_adm_7f3a...
@@ -40,7 +60,7 @@ ctx connect subscribe decision learning convention
 ### `ctx connect sync`
 
 Pull matching entries from the hub and write them to
-`.context/shared/` as markdown files with origin tags and date
+`.context/hub/` as markdown files with origin tags and date
 headers. Tracks last-seen sequence for incremental sync.
 
 ```bash
@@ -58,7 +78,7 @@ ctx connect publish decision "Use UTC timestamps everywhere"
 ### `ctx connect listen`
 
 Stream new entries from the hub in real-time. Writes to
-`.context/shared/` as entries arrive. Press Ctrl-C to stop.
+`.context/hub/` as entries arrive. Press Ctrl-C to stop.
 
 ```bash
 ctx connect listen
@@ -95,10 +115,10 @@ throttled). No manual `ctx connect sync` needed.
 
 ## Shared files
 
-Entries from the hub are stored in `.context/shared/`:
+Entries from the hub are stored in `.context/hub/`:
 
 ```
-.context/shared/
+.context/hub/
   decisions.md      # Shared decisions with origin tags
   learnings.md      # Shared learnings
   conventions.md    # Shared conventions
@@ -113,7 +133,7 @@ mixed with local context files.
 Include shared knowledge in agent context packets:
 
 ```bash
-ctx agent --include-shared
+ctx agent --include-hub
 ```
 
 Shared entries are included as Tier 8 in the budget-aware

docs/cli/connect.md

@@ -0,0 +1,73 @@
+---
+#   /    ctx:                         https://ctx.ist
+# ,'`./    do you remember?
+# `.,'\
+#   \    Copyright 2026-present Context contributors.
+#                 SPDX-License-Identifier: Apache-2.0
+
+title: Dependency graph
+icon: lucide/git-fork
+---
+
+## `ctx dep`
+
+Generate a dependency graph from source code.
+
+Auto-detects the project ecosystem from manifest files and
+outputs a dependency graph in Mermaid, table, or JSON format.
+
+```bash
+ctx dep [flags]
+```
+
+**Supported ecosystems**:
+
+| Ecosystem | Manifest                                | Method                                 |
+|-----------|-----------------------------------------|----------------------------------------|
+| Go        | `go.mod`                                | `go list -json ./...`                  |
+| Node.js   | `package.json`                          | Parse `package.json` (workspace-aware) |
+| Python    | `requirements.txt` or `pyproject.toml`  | Parse manifest directly                |
+| Rust      | `Cargo.toml`                            | `cargo metadata`                       |
+
+Detection order: Go, Node.js, Python, Rust. First match wins.
+
+**Flags**:
+
+| Flag         | Description                                     | Default       |
+|--------------|-------------------------------------------------|---------------|
+| `--format`   | Output format: `mermaid`, `table`, `json`       | `mermaid`     |
+| `--external` | Include external/third-party dependencies       | `false`       |
+| `--type`     | Force ecosystem: `go`, `node`, `python`, `rust` | auto-detect   |
+
+**Examples**:
+
+```bash
+# Auto-detect and show internal deps as Mermaid
+ctx dep
+
+# Include external dependencies
+ctx dep --external
+
+# Force Node.js detection (useful when multiple manifests exist)
+ctx dep --type node
+
+# Machine-readable output
+ctx dep --format json
+
+# Table format
+ctx dep --format table
+```
+
+**Ecosystem notes**:
+
+- **Go**: Uses `go list -json ./...`. Requires `go` in PATH.
+- **Node.js**: Parses `package.json` directly (no npm/yarn
+  needed). For monorepos with workspaces, shows
+  workspace-to-workspace deps (internal) or all deps per
+  workspace (external).
+- **Python**: Parses `requirements.txt` or `pyproject.toml`
+  directly (no pip needed). Shows declared dependencies; does
+  not trace imports. With `--external`, includes dev
+  dependencies from `pyproject.toml`.
+- **Rust**: Requires `cargo` in PATH. Uses `cargo metadata`
+  for accurate dependency resolution.

docs/cli/dep.md

@@ -0,0 +1,41 @@
+---
+#   /    ctx:                         https://ctx.ist
+# ,'`./    do you remember?
+# `.,'\
+#   \    Copyright 2026-present Context contributors.
+#                 SPDX-License-Identifier: Apache-2.0
+
+title: Guide
+icon: lucide/book-open
+---
+
+## `ctx guide`
+
+Quick-reference cheat sheet for common ctx commands and skills.
+
+```bash
+ctx guide [flags]
+```
+
+**Flags**:
+
+| Flag         | Description                  |
+|--------------|------------------------------|
+| `--skills`   | Show available skills        |
+| `--commands` | Show available CLI commands  |
+
+**Example**:
+
+```bash
+# Show the full cheat sheet
+ctx guide
+
+# Skills only
+ctx guide --skills
+
+# Commands only
+ctx guide --commands
+```
+
+Works without initialization (no `.context/` required). Useful
+for a printable one-pager when onboarding to a project.