@tekmidian/pai 0.11.0 → 0.12.1

package/docs/commands/observation.md

@@ -0,0 +1,80 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai observation
+
+> Observation capture: list, search, and stats
+
+## Synopsis
+
+```
+pai observation <subcommand> [options]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| [`pai observation list`](#pai-observation-list) | List recent observations |
+| [`pai observation search <query>`](#pai-observation-search-query) | Search observations by title or narrative text |
+| [`pai observation stats`](#pai-observation-stats) | Show observation statistics: totals, by type, by project |
+
+### pai observation list
+
+List recent observations
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--project <slug>` | Filter by project slug |  |
+| `--type <type>` | Filter by type (decision, bugfix, feature, refactor, discovery, change) |  |
+| `--session <id>` | Filter by session ID |  |
+| `--limit <n>` | Maximum results | `20` |
+
+
+### pai observation search <query>
+
+Search observations by title or narrative text
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<query>` | required |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--project <slug>` | Filter by project slug |  |
+| `--type <type>` | Filter by type |  |
+| `--limit <n>` | Maximum results | `20` |
+
+
+### pai observation stats
+
+Show observation statistics: totals, by type, by project
+
+
+## Examples
+
+```bash
+# Recent classified tool-call observations
+pai observation list
+
+# Only this project's decisions
+pai observation list --project pai --type decision
+
+# Search observations by text
+pai observation search "daemon socket"
+
+# Totals, by type, by project
+pai observation stats
+```
+
+## See also
+
+[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/obsidian.md

@@ -0,0 +1,60 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai obsidian
+
+> Obsidian vault: sync project notes, view status, open in Obsidian
+
+## Synopsis
+
+```
+pai obsidian <subcommand> [options]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| [`pai obsidian sync`](#pai-obsidian-sync) | Sync project Notes/ dirs into vault, generate _index.md and topic pages |
+| [`pai obsidian status`](#pai-obsidian-status) | Show vault health: healthy, broken, orphaned, and missing symlinks |
+| [`pai obsidian open`](#pai-obsidian-open) | Open the vault in Obsidian (macOS) |
+
+### pai obsidian sync
+
+Sync project Notes/ dirs into vault, generate _index.md and topic pages
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--vault <path>` | Override vault path (default: ~/.pai/obsidian-vault) |  |
+| `--quiet` | Minimal output — suitable for cron/hook use |  |
+
+
+### pai obsidian status
+
+Show vault health: healthy, broken, orphaned, and missing symlinks
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--vault <path>` | Override vault path |  |
+
+
+### pai obsidian open
+
+Open the vault in Obsidian (macOS)
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--vault <path>` | Override vault path |  |
+
+
+## See also
+
+[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/pause.md

@@ -0,0 +1,35 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai pause
+
+> Save state and display safe-exit instructions for the current session.
+
+Writes a ## Continue checkpoint to the project's TODO.md.
+Use `pai pause all` to pause every live session via AIBroker.
+
+## Synopsis
+
+```
+pai pause [target] [options]
+```
+
+## Arguments
+
+| Argument | Kind |
+|----------|------|
+| `[target]` | optional |
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--dry-run` | Preview changes without writing them |  |
+| `--exit` | (pause all only) Also send /exit to each session after pausing |  |
+| `--wait <ms>` | (pause all only) Milliseconds to wait before /exit (default: 5000) | `5000` |
+
+## See also
+
+[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/project.md

@@ -0,0 +1,345 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai project
+
+> Alias for `pai projects`
+
+## Synopsis
+
+```
+pai project <subcommand> [options]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| [`pai project list`](#pai-project-list) | Show the unified deduped listing (same as `pai`). |
+| [`pai project list-raw`](#pai-project-list-raw) | Raw registry listing with slug, path, status, last_active columns |
+| [`pai project cd <identifier>`](#pai-project-cd-identifier) | cd to a project directory. Short form: pai cd <name> |
+| [`pai project add <path>`](#pai-project-add-path) | Register a project directory in the PAI registry |
+| [`pai project info <slug>`](#pai-project-info-slug) | Show full details for a project |
+| [`pai project archive <slug>`](#pai-project-archive-slug) | Archive a project |
+| [`pai project unarchive <slug>`](#pai-project-unarchive-slug) | Restore an archived project to active status |
+| [`pai project move <slug> <new-path>`](#pai-project-move-slug-new-path) | Update the root path for a project |
+| [`pai project rebind <slug> <new-path>`](#pai-project-rebind-slug-new-path) | Manually update the root_path for a project (for when auto-detect found multiple matches). |
+| [`pai project tag <slug> <tags...>`](#pai-project-tag-slug-tags) | Add one or more tags to a project |
+| [`pai project alias <slug> <alias>`](#pai-project-alias-slug-alias) | Register an alternative slug for a project |
+| [`pai project edit <slug>`](#pai-project-edit-slug) | Edit project metadata |
+| [`pai project detect [path]`](#pai-project-detect-path) | Detect which registered project the given path (or CWD) belongs to |
+| [`pai project health`](#pai-project-health) | Audit all registered projects: check which paths still exist, find moved/dead projects |
+| [`pai project consolidate <identifier>`](#pai-project-consolidate-identifier) | Consolidate scattered ~/.claude/projects/.../Notes/ directories for a project into its canonical Notes/ location |
+| [`pai project promote`](#pai-project-promote) | Promote a session note into a new standalone project |
+| [`pai project go <query>`](#pai-project-go-query) | Print the root path for a project by slug, partial name, or fuzzy match. |
+| [`pai project name <identifier> <shortname>`](#pai-project-name-identifier-shortname) | Give a project a short name for quick access |
+| [`pai project unname <shortname>`](#pai-project-unname-shortname) | Remove a project's short name |
+| [`pai project names`](#pai-project-names) | List named projects (your curated shortlist) |
+| [`pai project config [identifier]`](#pai-project-config-identifier) | View or modify session launch config for a project. |
+
+### pai project list
+
+Show the unified deduped listing (same as `pai`).
+
+Use --all to include cold / zero-session / archived projects.
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--all` | Show all entries including cold / zero-session / archived projects |  |
+| `-n, --n <count>` | Max rows to show | `20` |
+
+
+### pai project list-raw
+
+Raw registry listing with slug, path, status, last_active columns
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--all` | Include archived projects (default: active only) |  |
+| `--status <status>` | Filter by status: active \| archived |  |
+| `--tag <tag>` | Filter by tag |  |
+| `--type <type>` | Filter by type |  |
+
+
+### pai project cd <identifier>
+
+cd to a project directory. Short form: pai cd <name>
+
+(The shell wrapper handles the actual cd; pure output here.)
+Auto-detects moved projects when the registered path no longer exists.
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<identifier>` | required |
+
+
+### pai project add <path>
+
+Register a project directory in the PAI registry
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<path>` | required |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--slug <slug>` | Override auto-generated slug |  |
+| `--type <type>` | Project type: local \| central \| obsidian-linked \| external | `local` |
+| `--display-name <name>` | Human-readable display name |  |
+
+
+### pai project info <slug>
+
+Show full details for a project
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+
+
+### pai project archive <slug>
+
+Archive a project
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+
+
+### pai project unarchive <slug>
+
+Restore an archived project to active status
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+
+
+### pai project move <slug> <new-path>
+
+Update the root path for a project
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+| `<new-path>` | required |
+
+
+### pai project rebind <slug> <new-path>
+
+Manually update the root_path for a project (for when auto-detect found multiple matches).
+
+Validates the new path exists and is a directory, then updates the registry.
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+| `<new-path>` | required |
+
+
+### pai project tag <slug> <tags...>
+
+Add one or more tags to a project
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+| `<tags...>` | variadic |
+
+
+### pai project alias <slug> <alias>
+
+Register an alternative slug for a project
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+| `<alias>` | required |
+
+
+### pai project edit <slug>
+
+Edit project metadata
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<slug>` | required |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--display-name <name>` | New display name |  |
+| `--type <type>` | New type |  |
+
+
+### pai project detect [path]
+
+Detect which registered project the given path (or CWD) belongs to
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `[path]` | optional |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--json` | Output raw JSON instead of human-readable text |  |
+
+
+### pai project health
+
+Audit all registered projects: check which paths still exist, find moved/dead projects
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--fix` | Auto-remediate where possible |  |
+| `--json` | Output raw JSON report |  |
+| `--status <category>` | Filter output to: active \| stale \| dead |  |
+
+
+### pai project consolidate <identifier>
+
+Consolidate scattered ~/.claude/projects/.../Notes/ directories for a project into its canonical Notes/ location
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<identifier>` | required |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--yes` | Perform consolidation without confirmation prompt |  |
+| `--dry-run` | Preview what would be moved without making changes |  |
+
+
+### pai project promote
+
+Promote a session note into a new standalone project
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--from-session <path>` | Path to the session note markdown file |  |
+| `--to <path>` | Directory path for the new project (must not exist) |  |
+| `--name <name>` | Display name for the new project (derived from filename if omitted) |  |
+
+
+### pai project go <query>
+
+Print the root path for a project by slug, partial name, or fuzzy match.
+
+Designed for shell integration: cd $(pai projects go <query>)
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<query>` | required |
+
+
+### pai project name <identifier> <shortname>
+
+Give a project a short name for quick access
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<identifier>` | required |
+| `<shortname>` | required |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--permission <level>` | Permission level: full \| trusted \| default |  |
+
+
+### pai project unname <shortname>
+
+Remove a project's short name
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `<shortname>` | required |
+
+
+### pai project names
+
+List named projects (your curated shortlist)
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--json` | Output JSON for AIBroker consumption |  |
+
+
+### pai project config [identifier]
+
+View or modify session launch config for a project.
+
+Use --options to discover available keys and presets.
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `[identifier]` | optional |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--set <key=value...>` | Set config values (repeatable) | `` |
+| `--unset <key...>` | Remove config keys (repeatable, use env.KEY for env vars) | `` |
+| `--preset <name>` | Apply a permission preset: full \| trusted \| default |  |
+| `--defaults` | Manage global session defaults instead of a project |  |
+| `--options` | List available config keys and presets |  |
+| `--json` | Output JSON |  |
+| `--reset` | Reset config to empty (inherit global defaults) |  |
+
+
+## See also
+
+[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+