@iamdevlinph/codex-kit 1.1.3 → 1.1.5

package/README.md

@@ -132,8 +132,9 @@ codex-kit project sync
 `project sync` never edits `AGENTS.md` or project skills. The reconciliation skill
 compares the refreshed template with the project's guidance and merges only
 applicable rules while preserving local organization and adaptations. If
-`TEMPLATE_AGENTS.md` was modified locally, sync preserves it for review instead
-of overwriting it.
+`TEMPLATE_AGENTS.md` was modified locally, sync overwrites it with the packaged
+template. Keep durable local rules in `AGENTS.md`; recover overwritten template
+edits through Git history when needed.
 
 After reconciliation and validation, Codex runs:
 
@@ -151,9 +152,8 @@ template still needs reconciliation.
   `CODEX_HOME` or `~/.codex`.
 - `--cwd PATH` selects a project directory for project commands instead of the
   current directory.
-- `--force` lets `global install`, `global configure`, `project init`, or
-  `project sync` replace modified files they manage. Use it only when you intend
-  to discard those local changes.
+- `--force` lets global commands replace modified files they manage. Use it only
+  when you intend to discard those local changes.
 
 Examples:
 

package/assets/TEMPLATE_AGENTS.md

@@ -141,16 +141,20 @@ conditional procedures into validated project skills.
 - Avoid broad commands. After changes, run the smallest targeted verification
   that meaningfully validates them when practical, then report the command and
   result. Use the repository's documented package manager and scripts.
-- For behavior changes and bug fixes, add or update the smallest focused
-  automated tests that meaningfully prevent regression when the repository has
-  an established test setup.
+- Select tests for regression value rather than exhaustive coverage. When the
+  repository has an established test setup, cover changed observable contracts,
+  reported regressions, meaningful boundaries, and plausible costly failures,
+  especially security, trust-boundary, or data-loss risks.
+- Use one representative case per equivalent behavior class. Skip redundant
+  permutations, implementation-detail assertions, and contrived or unreachable
+  states unless a requirement or past defect justifies them.
 - Treat existing tests as regression contracts. Preserve their assertions unless
   the requested behavior intentionally changes. When behavior changes, update
   only the affected tests and add coverage for the new contract; never weaken or
   delete tests merely to make the suite pass.
-- Do not introduce a test framework or create low-value tests solely to satisfy
-  this rule. If automated coverage is impractical, explain why and perform the
-  strongest targeted verification available.
+- Do not introduce a test framework solely to satisfy this rule. If automated
+  coverage is impractical, explain why and perform the strongest targeted
+  verification available.
 - Run the relevant focused tests after changing tested behavior.
 - When adding or updating dependencies, pin exact versions rather than ranges.
   With pnpm, use `pnpm add -E` (`--save-exact`).

package/assets/skills/codex-kit-reconcile-agents/SKILL.md

@@ -9,9 +9,7 @@ description: Reconcile a refreshed TEMPLATE_AGENTS.md with a project's AGENTS.md
 
 1. Inspect `AGENTS.md`, `TEMPLATE_AGENTS.md`, `.codex-kit-state.json`, the
    project's existing `.agents/skills`, and `codex-kit project status`. Record
-   the initial status before making changes. If a codex-kit template backup
-   exists, compare it with the refreshed template to isolate the actual template
-   change.
+   the initial status before making changes.
 2. Preserve the existing `AGENTS.md` organization and all project-specific
    adaptations. Merge only reusable template guidance that applies to this
    repository; report conflicts between local and template rules, and do not

package/bin/codex-kit.js

@@ -645,19 +645,8 @@ function syncProject(options) {
   const state = loadProjectState(cwd);
   if (existsSync6(stagedTemplate)) {
     const currentHash = sha256(read(stagedTemplate));
-    const locallyModified = currentHash !== sourceHash && (!state.template.availableHash || currentHash !== state.template.availableHash);
-    if (locallyModified && !options.force) {
-      console.warn(
-        `preserved locally modified template: ${stagedTemplate} (use --force to replace)`
-      );
-      console.log(
-        `The installed kit has template ${PACKAGE.version}; review the local change before syncing.`
-      );
-      return;
-    }
     if (currentHash === sourceHash) console.log(`unchanged: ${stagedTemplate}`);
     else {
-      backup(stagedTemplate);
       write(stagedTemplate, desired);
       console.log(`refreshed template reference: ${stagedTemplate}`);
     }
@@ -893,7 +882,6 @@ Options by command:
 
   project init, project sync
     --cwd PATH  Use a project directory other than the current directory.
-    --force     Replace modified files managed by codex-kit.
 
   project status, project mark-applied
     --cwd PATH  Use a project directory other than the current directory.
@@ -901,7 +889,7 @@ Options by command:
 Examples:
   codex-kit global install --force
   codex-kit global configure --reasoning-effort low --plan-reasoning-effort high
-  codex-kit project sync --cwd /path/to/project --force
+  codex-kit project sync --cwd /path/to/project
   codex-kit project status --cwd /path/to/project`);
 }
 async function main(argv = process.argv.slice(2)) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@iamdevlinph/codex-kit",
-	"version": "1.1.3",
+	"version": "1.1.5",
 	"description": "Portable Codex subagents and project AGENTS.md defaults.",
 	"type": "module",
 	"bin": {