@iamdevlinph/codex-kit 1.0.14 → 1.0.16

package/README.md

@@ -129,8 +129,8 @@ hooks. Modified managed files are preserved unless `--force` is supplied.
 
 | Action | Command |
 | --- | --- |
-| Show command help | `codex-kit --help` |
-| Print the installed version | `codex-kit --version` |
+| Show command help | `codex-kit -h` or `codex-kit --help` |
+| Print the installed version | `codex-kit -v` or `codex-kit --version` |
 | Install global agents and routing | `codex-kit global install` |
 | Configure the orchestrator | `codex-kit global configure` |
 | Inspect global configuration | `codex-kit global list` |

package/assets/TEMPLATE_AGENTS.md

@@ -123,6 +123,11 @@ conditional procedures into validated project skills.
 
 - Follow the repository's organization and naming. Prefer focused files and
   split mixed responsibilities when readability improves.
+- Use intent-revealing domain names. A reader should understand what a variable
+  contains or what a helper guarantees at the call site without opening its
+  implementation. Avoid vague transformation names such as `normalized`,
+  `processed`, `result`, or `data` when a value- or behavior-specific name is
+  available.
 - Do not reorganize feature directories, shared modules, routes, server
   boundaries, schemas, or state patterns unless requested and approved.
 

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

@@ -8,9 +8,10 @@ description: Reconcile a refreshed TEMPLATE_AGENTS.md with a project's AGENTS.md
 ## Procedure
 
 1. Inspect `AGENTS.md`, `TEMPLATE_AGENTS.md`, `.codex-kit-state.json`, the
-   project's existing `.agents/skills`, and `codex-kit project status`. If a
-   codex-kit template backup exists, compare it with the refreshed template to
-   isolate the actual template change.
+   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.
 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
@@ -25,8 +26,14 @@ description: Reconcile a refreshed TEMPLATE_AGENTS.md with a project's AGENTS.md
    unintended template edits. Validate every created or modified project skill
    with an available skill validator and run the repository's documented checks.
    Do not mark the template applied until reconciliation and validation succeed.
-6. Run `codex-kit project mark-applied` only after successful reconciliation and
-   validation, then confirm `codex-kit project status` is up to date.
+6. Never run `codex-kit project sync` on the user's behalf or recommend it for
+   an unreleased local template edit. The user should run `project sync` only
+   after updating codex-kit to a released version containing the template
+   change. Run `codex-kit project mark-applied` only when the task follows a
+   user-run `project init` or eligible `project sync`, the initial status
+   recorded in step 1 was `reconciliation required`, and reconciliation and
+   validation succeeded. Otherwise leave project state unchanged and report the
+   remaining release, codex-kit update, user-run sync, and reconciliation steps.
 7. Summarize added, updated, skipped, adapted, and skill-moved guidance, with
    reasons. Identify genuinely reusable, generalized changes that should be
    promoted to codex-kit's canonical template and report the target section and

package/bin/codex-kit.js

@@ -70,8 +70,8 @@ Commands:
   project status       Show whether template changes still need reconciliation.
   project mark-applied Record the current template as reconciled with AGENTS.md.
   version check        Compare the installed version with the latest npm release.
-  --help               Show this help.
-  --version            Print the installed version.
+  -h, --help           Show this help.
+  -v, --version        Print the installed version.
 
 Options by command:
   global install
@@ -100,4 +100,4 @@ 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 status --cwd /path/to/project`)}function Y(o=process.argv.slice(2)){let e=we(o);if(e.positionals.includes("--version")){console.log(p.version);return}if(!e.positionals.length||e.positionals.includes("--help")){ao();return}let[t,n]=e.positionals;if(t==="global"&&n==="install")me(e);else if(t==="global"&&n==="configure")z(e);else if(t==="global"&&n==="list")ue(e);else if(t==="global"&&n==="uninstall")he(e);else if(t==="project"&&(n==="init"||n==="sync"))be(e);else if(t==="project"&&n==="status")ye(e);else if(t==="project"&&n==="mark-applied")ve(e);else if(t==="version"&&n==="check")xe();else throw new Error(`Unknown command: ${e.positionals.join(" ")}`)}if(process.argv[1]&&$e(lo(process.argv[1]))===$e(co(import.meta.url)))try{Y()}catch(o){console.error(`error: ${o instanceof Error?o.message:String(o)}`),process.exitCode=1}export{Y as main};
+  codex-kit project status --cwd /path/to/project`)}function Y(o=process.argv.slice(2)){let e=we(o);if(e.positionals.includes("--version")||e.positionals.includes("-v")){console.log(p.version);return}if(!e.positionals.length||e.positionals.includes("--help")||e.positionals.includes("-h")){ao();return}let[t,n]=e.positionals;if(t==="global"&&n==="install")me(e);else if(t==="global"&&n==="configure")z(e);else if(t==="global"&&n==="list")ue(e);else if(t==="global"&&n==="uninstall")he(e);else if(t==="project"&&(n==="init"||n==="sync"))be(e);else if(t==="project"&&n==="status")ye(e);else if(t==="project"&&n==="mark-applied")ve(e);else if(t==="version"&&n==="check")xe();else throw new Error(`Unknown command: ${e.positionals.join(" ")}`)}if(process.argv[1]&&$e(lo(process.argv[1]))===$e(co(import.meta.url)))try{Y()}catch(o){console.error(`error: ${o instanceof Error?o.message:String(o)}`),process.exitCode=1}export{Y as main};

package/package.json

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