@cesarandreslopez/occ 0.8.12 → 0.9.0

package/skills/occ/reference/git.md

@@ -0,0 +1,55 @@
+# Git context
+
+Inspect git changes, history, and churn. Shared flags: `--path <repo-root>`
+(default cwd), `--base <ref>`, `--head <ref>`, `--staged`, `--format
+tabular|json`, `-o <file>`. The diff range is resolved from `--base`/`--head`/
+`--staged` (defaults to the working-tree changes when unspecified).
+
+## `occ git changed`
+
+List changed files for the resolved diff range — a quick scope check.
+
+```bash
+occ git changed --path .
+occ git changed --base main --format json
+```
+
+## `occ git diff`
+
+Summarize the resolved diff, or render it as a bounded patch.
+
+```bash
+occ git diff --format json                              # summary (files, +/- counts)
+occ git diff --patch --map-tokens 2048 --tokenizer o200k_base   # raw patch, token-bounded
+```
+
+Flags: `--patch` (raw unified diff instead of summary), `--map-tokens <n>` +
+`--tokenizer` to cap patch size.
+
+## `occ git history [file]`
+
+Show commit history for a range or a file (hash, author date, subject).
+
+```bash
+occ git history src/cli.ts --limit 10
+occ git history --since 2025-01-01 --format json
+```
+
+Flags: `--limit <n>` (default 50), `--since <date>`, `--follow` (track renames),
+`--line-start <n>` / `--line-end <n>` (for `git log -L` line history).
+
+## `occ git churn`
+
+Rank changed files by churn — find hotspots worth attention.
+
+```bash
+occ git churn --sort churn --limit 20 --format json
+```
+
+Flags: `--sort churn|commits|added|deleted|net` (default churn), `--limit <n>`,
+`--since <date>`.
+
+## Symbol-level changes
+
+To see which _symbols_ (not just files/lines) changed, use `occ code diff`
+(see [code.md](code.md)).

package/skills/occ/reference/workspace.md

@@ -0,0 +1,65 @@
+# Workspace reconnaissance
+
+Use these to understand _what a directory is_ and inventory its contents before
+reading anything in depth. All accept `--format json` and `-o <file>`.
+
+## `occ [directories...]` — the root scan
+
+scc-style summary tables for office documents (and, by default, `scc` code metrics).
+
+```bash
+occ docs/ reports/                 # tabular metrics grouped by type
+occ . --format json                # machine-readable inventory
+occ . --structure --format json    # also extract heading trees (RAG-friendly, with char offsets)
+occ . --quick                      # file count + size by extension, skip parsing (fast)
+```
+
+Useful flags: `-f, --by-file` (row per file), `--include-ext`/`--exclude-ext`,
+`--exclude-dir <dirs>` (default `node_modules,.git`), `--no-gitignore`,
+`--sort files|name|words|size`, `--token-budget <n>` with `--tokenizer
+heuristic|o200k_base|cl100k_base`, `--large-file-limit <mb>` (default 50),
+`--no-code` (skip scc), `-o <file>`, `--ci` (ASCII only).
+
+## `occ describe [directories...]`
+
+Quickly classify one or more directories from fast file and manifest signals
+(is this a code / office / documentation / data / mixed project?).
+
+```bash
+occ describe . --format json
+occ describe apps/* --quiet        # summary only
+```
+
+Flags: `--full` (full report), `--quiet` (summary only), `--max-projects <n>`
+(default 25), `--exclude-dir`, `--no-gitignore`, `-o`.
+
+## `occ workspace describe [rootDir]`
+
+Same classification as `occ describe`, scoped to a single workspace root.
+
+## `occ workspace analyze [rootDir]`
+
+Analyze workspace code, documents, and structures with a versioned JSON contract.
+Defaults to `--format json`. This is the one-call snapshot for agents.
+
+```bash
+occ workspace analyze . -o ws.json
+occ workspace analyze . --no-documents     # code + structures only
+```
+
+Flags: `--no-code`, `--no-documents`, `--no-structures`, `--exclude-dir`,
+`--large-file-limit <mb>`, `--no-gitignore`, `-o`.
+
+## `occ workspace documents [rootDir]`
+
+Inspect workspace document summaries and cross-document references. Defaults to
+`--format json`.
+
+Flags: `--max-files <n>` (default 50), `--max-reference-files <n>` (default 20),
+`--include-markdown`, `--exclude-dir`, `-o`.
+
+## Suggested sequence
+
+1. `occ describe . --format json` — what am I looking at?
+2. `occ workspace analyze . --format json -o ws.json` — full inventory.
+3. Drill into specifics with the code or document commands.