@kevin0181/memoc 1.1.3 → 1.1.10

package/README.md

@@ -82,6 +82,14 @@ npx @kevin0181/memoc init
 # Re-scan project and refresh managed sections
 npx @kevin0181/memoc update
 
+# Shared repo activity tracking
+npx @kevin0181/memoc actor
+npx @kevin0181/memoc actor set neneee
+npx @kevin0181/memoc work "Auth refresh fix" --from-git
+npx @kevin0181/memoc activity
+npx @kevin0181/memoc activity --write
+npx @kevin0181/memoc doctor
+
 # Print current status in ~10 lines
 npx @kevin0181/memoc summary
 
@@ -93,10 +101,19 @@ npx @kevin0181/memoc search "auth" --snippets --limit 5
 npx @kevin0181/memoc grep "GetParticles"
 npx @kevin0181/memoc grep "GetParticles" --snippets --limit 5
 
+# Create raw/source records and durable wiki topic notes
+npx @kevin0181/memoc ingest path/to/source.md
+npx @kevin0181/memoc ingest https://example.com/spec
+npx @kevin0181/memoc note "Auth flow comparison"
+npx @kevin0181/memoc lint-wiki
+
 # Estimate token cost of current memory files
 npx @kevin0181/memoc tokens
 
-# Archive old log entries to keep log.md small
+# Archive and compact an oversized startup summary
+npx @kevin0181/memoc trim-summary
+
+# Legacy: archive old log.md entries before deleting/migrating log.md
 npx @kevin0181/memoc compress
 
 # Add the same protocol to another agent's entry file
@@ -123,7 +140,7 @@ Run it from the project root. It preserves existing project memory, including:
 - `.memoc/03-decisions.md`
 - `.memoc/04-handoff.md`
 - `.memoc/06-project-rules.md`
-- `.memoc/log.md`
+- Legacy `.memoc/log.md` if present
 - `.memoc/systems/`
 - `.memoc/wiki/`
 
@@ -155,7 +172,10 @@ llms.txt                                     ← LLM-facing project map
   03-decisions.md                            ← Durable decision log
   04-handoff.md                              ← Resume context, verified/unverified
   06-project-rules.md                        ← User preferences
-  log.md                                     ← Append-only activity log
+  activity.md                                ← Short shared activity index
+  actors/                                    ← Actor profiles for shared repos
+  worklog/                                   ← Per-actor work records to reduce conflicts
+  raw/                                       ← Immutable source material, not a startup read
   systems/                                   ← Subsystem docs
   wiki/                                      ← Synthesized knowledge base
 
@@ -172,10 +192,14 @@ Every entry file (`CLAUDE.md`, `AGENTS.md`, `.cursorrules`, etc.) gets the same
 ## Session Start
 - [ ] Read `.memoc/session-summary.md`
 - [ ] `.pending` exists? → review changed files → update memory if needed → delete it
+- [ ] If `memoc` is not found, use the project-local wrapper.
 
 ## Before Opening More Files
 - [ ] Run `memoc search "<query>"` first
 - [ ] Open on demand: `02` status · `04` resume · `06` rules · `llms.txt` map
+- [ ] Use `memoc grep "<query>"` only when memory is not enough.
+- [ ] For durable source/wiki work, use `memoc ingest`, `memoc note`, and `memoc lint-wiki`.
+- [ ] In shared repos, record meaningful work with `memoc work "<title>"`.
 - [ ] Keep output small: `summary`, `search --limit`, `search --snippets`
 
 ## Before Finishing _(update only applicable files; skip Q&A / throwaway exploration)_
@@ -184,6 +208,8 @@ Every entry file (`CLAUDE.md`, `AGENTS.md`, `.cursorrules`, etc.) gets the same
 - [ ] Work incomplete or risky → `04-handoff.md` (verified commands, unverified items, next steps)
 - [ ] Rule/preference set → `06-project-rules.md`
 - [ ] Wiki/systems work → read `skills/project-memory-maintainer/SKILL.md`
+- [ ] Shared repo work → prefer `memoc work "<title>" --from-git`; run `memoc activity --write` only when regenerating indexes.
+- [ ] Keep `session-summary.md` replace-only; completed work belongs in actor worklogs.
 ```
 
 The checklist tells agents exactly when to update, which file to update, and what to record — so nothing gets missed.
@@ -202,6 +228,8 @@ Startup cost is kept minimal by design.
 
 Everything else is on-demand. Use `memoc tokens` to see the live breakdown for your project.
 
+`session-summary.md` is a replace-only startup snapshot, not a timeline. If it grows beyond the warning threshold, run `memoc trim-summary`; completed history belongs in `.memoc/worklog/<actor>/YYYY-MM/`, and unfinished/risky resume detail belongs in `.memoc/04-handoff.md`.
+
 ---
 
 ## Claude Code Auto-Detection
@@ -233,6 +261,24 @@ Add more agents on demand:
 
 Running `update` refreshes managed blocks in all existing agent files.
 
+## Shared Repos
+
+Use `memoc work "<title>" --from-git` for meaningful work in shared repositories. It creates a new actor-scoped file under `.memoc/worklog/<actor>/YYYY-MM/`, prefills branch and changed files from git, and avoids append conflicts in shared files.
+
+Actor detection order:
+
+1. `MEMOC_ACTOR`
+2. `.memoc/local/actor` from `memoc actor set <name>`
+3. `git config user.name`
+4. `git config user.email`
+5. OS username
+
+`.memoc/local/` is ignored by git so each machine can keep its own actor setting.
+
+`activity.md`, `actors/README.md`, and `worklog/README.md` are regenerated indexes. Run `memoc activity --write` when you want to refresh them from worklog files.
+
+`log.md` is legacy. New installs do not create it, and shared activity should live in worklog files. Existing projects can delete `.memoc/log.md` after preserving any useful history in worklogs or archives.
+
 ---
 
 ## Supported Stacks
@@ -248,7 +294,7 @@ Node.js · Next.js · React · Vue · Svelte · Angular · Nuxt · Astro · Expr
 - **New project** — scaffolds all memory files with sensible defaults.
 - **Existing project** — detects your stack and fills in real project info (name, scripts, config files).
 - **Already initialized** — `init` injects the managed block without touching your existing content. `update` re-scans and refreshes project-specific sections.
-- **Long-running projects** — run `compress` to archive old `log.md` entries when the file grows large.
+- **Long-running projects** — use actor worklogs for history; `compress` remains only for old `log.md` files.
 
 ---