@iamdevlinph/codex-kit 1.1.4 → 1.1.6

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

@@ -89,9 +89,12 @@ conditional procedures into validated project skills.
 - Work within imperfect architecture. If it prevents safe completion, stop,
   explain the limitation, propose the smallest viable design change, and wait
   for approval. Escalate blockers instead of bypassing them.
-- Reuse existing constants, schemas, enums, shared types, and components before
-  creating duplicates. Add reusable domain values at their existing source of
-  truth instead of scattering magic strings.
+- Keep identical configuration and behavior in one source of truth at the
+  narrowest shared scope. Reuse that owner across callers or features; create a
+  separate implementation or instance only when scope, lifecycle, or behavior
+  genuinely differs. Reuse existing constants, schemas, enums, shared types,
+  and components before creating duplicates. Add reusable domain values at
+  their existing source of truth instead of scattering magic strings.
 - Replace numeric literals that encode domain rules, limits, durations, units,
   or protocol values with descriptively named constants. Universally obvious
   structural values, such as basic indexes or empty-state values, may remain

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.4",
+	"version": "1.1.6",
 	"description": "Portable Codex subagents and project AGENTS.md defaults.",
 	"type": "module",
 	"bin": {