@dotdotgod/codex 0.1.17 → 0.1.19

package/README.md

@@ -1,19 +1,50 @@
 # @dotdotgod/codex
 
+[![npm version](https://img.shields.io/npm/v/@dotdotgod/codex.svg)](https://www.npmjs.com/package/@dotdotgod/codex) [![GitHub](https://img.shields.io/badge/GitHub-dotdotgod%2Fdotdotgod-181717?logo=github)](https://github.com/dotdotgod/dotdotgod/tree/main/packages/codex) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
+
 > **Change a file, know what else must be checked.**
 
-Codex adapter for dotdotgod's context curation workflow. It packages reusable skills that help Codex load curated project memory, plan from docs before implementation, and initialize the shared agent documentation scaffold so changes start with the right specs, tests, plans, and archive map.
+```bash
+$ dotdotgod graph impact . --changed packages/cli/src/core.mjs --compact
+```
+
+```text
+docs:
+- docs/spec/REFERENCE_EXPANSION.md (91; incoming:implemented_by, semantic_similarity)
+- docs/test/REFERENCE_EXPANSION.md (65.3; verified_by, semantic_similarity)
+- docs/spec/LOAD_PROJECT.md (35.8; related_doc, semantic_similarity)
+
+tests:
+- packages/cli/test/core.test.mjs (78.6; semantic_similarity, incoming:semantic_similarity, verified_by)
+- packages/cli/test/e2e.test.mjs (51.4; verified_by)
+
+files:
+- packages/cli/src/core.mjs (100; changed-file)
+- packages/pi/extensions/plan-mode/index.ts (45; implemented_by, semantic_similarity)
+```
+
+`graph impact` ranks the specs, tests, architecture notes, config docs, and source files most likely to matter for a change. `--compact` keeps the result agent-facing: grouped by docs/tests/files and annotated with the reasons each item is likely relevant. It uses the project-memory graph built from Markdown links, README routes, headings, traceability blocks, package metadata, memory areas, and deterministic routing hints.
+
+Codex adapter for dotdotgod's context curation workflow. It packages reusable skills that help Codex initialize shared agent docs, load bounded project memory, and plan from docs before implementation.
 
 ## What Gets Better?
 
 - Codex can start from `AGENTS.md` and the dotdotgod docs map.
 - Load guidance prefers `dotdotgod load-snapshot <root> --json` when the CLI is available, then falls back to README-index reads.
 - Codex can use docs structure as retrieval intent: specs for behavior, architecture for rationale, tests for verification, plans for current work, and archive indexes for past decisions.
-- Product intent, design rationale, and verification standards stay in durable docs.
 - Planning work captures current intent in `docs/plan/<task-slug>/README.md` before implementation.
 - Completed plans and temporary reports use the same archive structure as Pi and Claude Code, turning outcomes into future context.
 - `dd:load`, `dd:plan`, and `dd:init` can be used as command-like trigger phrases where direct slash commands are unavailable.
 
+## Shared Memory and Traceability Model
+
+By default, `docs/spec/**` has two roles: it is stable shared/fresh project memory, and it is the traceability-enforced behavior-spec path. These concepts are independent:
+
+- `memory.areas` customizes memory classification, freshness, local/shared scope, priorities, and archive-body inclusion.
+- `traceability.required` / `traceability.exclude` customizes which markdown paths must end with `json dotdotgod` blocks.
+
+`docs/archive/README.md` is the history map. Archive bodies remain targeted historical memory and should not be read broadly by default.
+
 ## Included
 
 - Codex plugin manifest: `.codex-plugin/plugin.json`
@@ -30,6 +61,15 @@ Codex can run lifecycle hooks from trusted Codex configuration layers. dotdotgod
 
 Use hooks only when you want opt-in reminders or validation around the same workflow. See [`hooks/README.md`](hooks/README.md) for advisory examples and stricter plan-safety patterns.
 
+## Shared Contract
+
+- `AGENTS.md` remains canonical.
+- `CODEX.md` stays thin and points to `AGENTS.md`.
+- Active plans use `docs/plan/<task-slug>/README.md`.
+- Completed plans move to `docs/archive/plan/<task-slug>/`.
+- Temporary reports move to `docs/archive/report/<report-slug>/`.
+- `docs/archive/README.md` is the archive map; archive bodies should be read only when targeted.
+
 ## Local Development
 
 Run package checks:
@@ -39,17 +79,10 @@ pnpm --filter @dotdotgod/codex run verify
 pnpm --filter @dotdotgod/codex run pack:dry-run
 ```
 
-## Shared Contract
+## Learn More
 
-- `AGENTS.md` remains canonical.
-- `CODEX.md` stays thin and points to `AGENTS.md`.
-- Active plans use `docs/plan/<task-slug>/README.md`.
-- Completed plans move to `docs/archive/plan/<task-slug>/`.
-- Temporary reports move to `docs/archive/report/<report-slug>/`.
-- `docs/archive/README.md` is the archive map; archive bodies should be read only when targeted.
+See the [root README](../../README.md), [GitHub repository](https://github.com/dotdotgod/dotdotgod), [`docs/concept/CONTEXT_CURATION.md`](../../docs/concept/CONTEXT_CURATION.md), [`docs/concept/CONTEXT_MECHANICS.md`](../../docs/concept/CONTEXT_MECHANICS.md), [`docs/spec/MEMORY_AREA_CONFIG.md`](../../docs/spec/MEMORY_AREA_CONFIG.md), and [`docs/spec/TRACEABILITY_CONFIG.md`](../../docs/spec/TRACEABILITY_CONFIG.md).
 
 ## Compared with Graphify-Style Memory
 
-This adapter packages reusable workflow skills. It guides Codex to prefer a bounded dotdotgod load snapshot when available, avoid broad archive scans, and follow README indexes before reading raw files.
-
-The strength is structured retrieval: project docs declare which files are rules, specs, architecture, verification, active intent, or historical memory. That keeps the memory layer portable across Codex runtimes and useful on small tasks where a large graph report would be overhead.
+This adapter packages reusable workflow skills. It guides Codex to prefer a bounded dotdotgod load snapshot when available, avoid broad archive scans, and follow README indexes before reading raw files. The strength is structured retrieval from project-declared memory, not a giant graph report.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/codex",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Codex adapter for dotdotgod project memory workflows.",
   "type": "module",
   "license": "MIT",
@@ -8,13 +8,17 @@
     "access": "public"
   },
   "keywords": [
-    "codex",
-    "dotdotgod",
     "agent-memory",
+    "ai-coding-agent",
+    "codex",
+    "context-curation",
     "documentation",
+    "dotdotgod",
+    "graph-impact",
+    "planning",
     "plugin",
     "project-memory",
-    "planning"
+    "traceability"
   ],
   "scripts": {
     "verify": "node -e \"const fs=require('fs'); const req=['.codex-plugin/plugin.json','skills/project-load/SKILL.md','skills/doc-first-planning/SKILL.md','skills/project-initializer/SKILL.md','skills/project-initializer/scripts/init_project.sh','hooks/README.md']; JSON.parse(fs.readFileSync('.codex-plugin/plugin.json','utf8')); for (const f of req) { if (!fs.existsSync(f)) throw new Error('missing '+f); } console.log('codex adapter ok')\"",
@@ -26,5 +30,14 @@
     "hooks",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "homepage": "https://github.com/dotdotgod/dotdotgod/tree/main/packages/codex#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dotdotgod/dotdotgod.git",
+    "directory": "packages/codex"
+  },
+  "bugs": {
+    "url": "https://github.com/dotdotgod/dotdotgod/issues"
+  }
 }