@nolrm/contextkit 0.12.17 → 0.12.19

package/README.md

@@ -318,6 +318,7 @@ ck vscode      # alias for copilot
 # Analysis & Updates
 /analyze       # customize standards to your project (slash command in your AI tool)
 ck update      # pull latest commands/hooks — preserves your analyzed standards
+               # updates are also flagged automatically after each ck command (24h cache)
 ck status      # check install & integrations
 
 # Validation & Compliance

package/bin/contextkit.js

@@ -12,6 +12,9 @@ const publish = require('../lib/commands/publish');
 const pull = require('../lib/commands/pull');
 const dashboard = require('../lib/commands/dashboard');
 const packageJson = require('../package.json');
+const { checkForUpdates } = require('../lib/utils/notifier');
+
+checkForUpdates();
 
 // Set up the CLI
 program

package/lib/commands/install.js

@@ -734,6 +734,10 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${this.repoUrl}/commands/squad-reset.md`,
         '.contextkit/commands/squad-reset.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/health-check.md`,
+        '.contextkit/commands/health-check.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
@@ -792,7 +796,6 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
     await this.createCorrectionsLog();
     await this.createMetaInstructions();
     await this.createPolicyFile();
-    await this.createHealthCheckCommand();
 
     // Install CLI helpers
     await this.installCLIHelpers();
@@ -1592,58 +1595,6 @@ enforcement:
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  async createHealthCheckCommand() {
-    const healthCheckContent = `# ContextKit Health Check
-
-Check this project's ContextKit setup and report status.
-
-## Steps
-
-1. Check if \`.contextkit/\` directory exists. If not → STOP and tell user: "Run \`ck install\` to set up ContextKit."
-
-2. Read \`.contextkit/config.yml\` and check the \`last_analyzed\` field.
-
-3. Check each standards file for skeleton markers. Read these files and check if they contain \`<!-- Content will be generated by running: /analyze -->\`:
-   - \`.contextkit/standards/code-style.md\`
-   - \`.contextkit/standards/testing.md\`
-   - \`.contextkit/standards/architecture.md\`
-   - \`.contextkit/standards/ai-guidelines.md\`
-   - \`.contextkit/standards/workflows.md\`
-   - \`.contextkit/standards/glossary.md\`
-
-4. Check product files for placeholder content (e.g., \`[ELEVATOR_PITCH_FROM_MISSION_MD]\`):
-   - \`.contextkit/product/mission-lite.md\`
-   - \`.contextkit/product/decisions.md\`
-   - \`.contextkit/product/roadmap.md\`
-
-5. Check which platform integrations exist:
-   - \`CLAUDE.md\` → Claude Code
-   - \`.cursor/rules/\` → Cursor
-   - \`AGENTS.md\` → Codex
-   - \`GEMINI.md\` → Gemini
-   - \`CONVENTIONS.md\` → Aider
-   - \`.windsurfrules\` → Windsurf
-   - \`.github/copilot-instructions.md\` → Copilot
-
-6. Report findings as a status summary table and list recommended next steps.
-
-## Output Format
-
-| Area | Status | Action |
-|------|--------|--------|
-| Installation | OK/Missing | \`ck install\` |
-| Standards | Populated/Skeleton | \`ck analyze\` or \`/analyze\` |
-| Product context | Populated/Placeholder | Edit \`.contextkit/product/\` files |
-| Integrations | List active | \`ck <platform>\` to add more |
-
-## Token Note
-
-If standards are still skeletons, warn that @imports in CLAUDE.md are loading empty files — wasting context tokens. Run \`/analyze\` to populate them.
-`;
-
-    await fs.writeFile('.contextkit/commands/health-check.md', healthCheckContent);
-  }
-
   showSuccessMessage(hookChoices, platform = null, projectType = '', packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));

package/lib/commands/update.js

@@ -291,6 +291,10 @@ class UpdateCommand {
         `${this.repoUrl}/commands/squad-reset.md`,
         '.contextkit/commands/squad-reset.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/health-check.md`,
+        '.contextkit/commands/health-check.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(

package/lib/integrations/claude-integration.js

@@ -82,11 +82,16 @@ The following standards are auto-loaded into context via @imports:
   }
 
   async generateFiles() {
+    const { version } = require('../../package.json');
+
     // Bridge file: CLAUDE.md (auto-loaded every session)
     const bridgeContent = `# Project Standards (ContextKit)
 
 This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
 
+## ContextKit
+Version: ${version}
+
 ${this.getStandardsBlock()}
 
 ## Corrections Log

package/lib/utils/notifier.js

@@ -0,0 +1,17 @@
+const updateNotifier = require('update-notifier');
+const pkg = require('../../package.json');
+
+/**
+ * Check for available updates to @nolrm/contextkit on npm.
+ * Results are cached for 24 hours. Notification prints after the command
+ * completes. Suppressed automatically in CI environments.
+ */
+function checkForUpdates() {
+  try {
+    updateNotifier({ pkg }).notify();
+  } catch (err) {
+    // Never crash the CLI due to a notifier failure
+  }
+}
+
+module.exports = { checkForUpdates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.17",
+  "version": "0.12.19",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {
@@ -69,7 +69,8 @@
     "fs-extra": "^11.1.1",
     "inquirer": "^8.2.6",
     "js-yaml": "^4.1.0",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "update-notifier": "^5.1.0"
   },
   "files": [
     "bin/",