speclock 1.4.1 → 1.5.0

package/README.md

@@ -76,7 +76,7 @@ Or run it yourself:
 npx speclock setup --goal "Build my app"
 ```
 
-**That's it.** The AI reads `SPECLOCK.md`, follows the rules, and uses CLI commands. Tested on Bolt.new — the AI ran 17 commands automatically on first install, setting up goals, locks, and decisions without any configuration.
+**That's it.** SpecLock creates `SPECLOCK.md`, injects a marker into `package.json`, and generates `.speclock/context/latest.md`. The AI reads these automatically and follows the rules. When the AI returns in a new session, it sees the SpecLock marker in `package.json` and knows to check the rules before making changes.
 
 ### Lovable (MCP Remote — No Install)
 
@@ -287,4 +287,4 @@ MIT License - see [LICENSE](LICENSE) file.
 
 ---
 
-*SpecLock v1.3.1 — Because remembering isn't enough. AI needs to respect boundaries.*
+*SpecLock v1.5.0 — Because remembering isn't enough. AI needs to respect boundaries.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speclock",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "AI constraint engine — MCP server + CLI with active enforcement. Memory + guardrails for AI coding tools. Works with Bolt.new, Claude Code, Cursor, Lovable.",
   "type": "module",
   "main": "src/mcp/server.js",

package/src/cli/index.js

@@ -13,6 +13,7 @@ import {
   createSpecLockMd,
   guardFile,
   unguardFile,
+  injectPackageJsonMarker,
 } from "../core/engine.js";
 import { generateContext } from "../core/context.js";
 import { readBrain } from "../core/storage.js";
@@ -71,7 +72,7 @@ function refreshContext(root) {
 
 function printHelp() {
   console.log(`
-SpecLock v1.4.0 — AI Constraint Engine
+SpecLock v1.5.0 — AI Constraint Engine
 Developed by Sandeep Roy (github.com/sgroy10)
 
 Usage: speclock <command> [options]
@@ -181,18 +182,25 @@ async function main() {
     const mdPath = createSpecLockMd(root);
     console.log(`Created SPECLOCK.md (AI instructions file).`);
 
-    // 4. Generate context
+    // 4. Inject marker into package.json (so AI tools auto-discover SpecLock)
+    const pkgResult = injectPackageJsonMarker(root);
+    if (pkgResult.success) {
+      console.log("Injected SpecLock marker into package.json.");
+    }
+
+    // 5. Generate context
     generateContext(root);
     console.log("Generated .speclock/context/latest.md");
 
-    // 5. Print summary
+    // 6. Print summary
     console.log(`
 SpecLock is ready!
 
-Files created:
+Files created/updated:
   .speclock/brain.json          — Project memory
   .speclock/context/latest.md   — Context for AI (read this)
   SPECLOCK.md                   — AI rules (read this)
+  package.json                  — SpecLock marker added (AI auto-discovery)
 
 Next steps:
   The AI should read SPECLOCK.md for rules and
@@ -210,8 +218,9 @@ Next steps:
   if (cmd === "init") {
     ensureInit(root);
     createSpecLockMd(root);
+    injectPackageJsonMarker(root);
     generateContext(root);
-    console.log("SpecLock initialized. Created SPECLOCK.md and context file.");
+    console.log("SpecLock initialized. Created SPECLOCK.md, updated package.json, and generated context file.");
     return;
   }
 

package/src/core/engine.js

@@ -704,8 +704,24 @@ export function createSpecLockMd(root) {
 
 ## STOP — Read this before doing ANYTHING.
 
+This project has SpecLock installed. It tracks project memory, goals, constraints (locks), and decisions.
+
+**Step 1:** Read \`.speclock/context/latest.md\` — this contains the full project memory.
+**Step 2:** Follow ALL rules below on every message.
+
 **If a file contains "SPECLOCK-GUARD" at the top → DO NOT EDIT IT. Period.**
 
+## Returning to This Project? (New Chat Session)
+
+If you are starting a new chat on this project:
+1. SpecLock is ALREADY installed — do NOT reinstall it
+2. The \`.speclock/\` directory contains all project memory
+3. Run \`npx speclock status\` to see the current state
+4. Read \`.speclock/context/latest.md\` for full context (goals, locks, decisions, history)
+5. Respect ALL existing locks and constraints before making any changes
+
+**DO NOT say "SpecLock is not installed" — if you can read this file, it IS installed.**
+
 ## Your Job (Do This Automatically — The User Will NOT Ask)
 
 ### On EVERY message:
@@ -748,6 +764,7 @@ User might say "actually, let me change auth" or "ok modify the database."
 ## Commands
 
 \`\`\`bash
+npx speclock status                              # CHECK IF ALREADY SET UP
 npx speclock check "what you plan to do"         # ALWAYS RUN BEFORE CHANGES
 npx speclock lock "constraint"                   # Lock a constraint
 npx speclock guard <file> --lock "constraint"    # Protect a specific file
@@ -756,7 +773,6 @@ npx speclock lock remove <lockId>                # Unlock a constraint
 npx speclock log-change "what changed"           # Log changes
 npx speclock decide "decision"                   # Record a decision
 npx speclock context                             # Refresh context file
-npx speclock status                              # See project summary
 \`\`\`
 
 ## Key Rule
@@ -764,6 +780,7 @@ npx speclock status                              # See project summary
 **The user will NEVER tell you to run these commands. You run them automatically.**
 **The user will NEVER say "lock this." You detect the intent and lock it yourself.**
 **The user will NEVER say "check constraints." You check before EVERY code change.**
+**If this file exists, SpecLock is installed. Do NOT reinstall. Just read the context and follow the rules.**
 `;
   const filePath = path.join(root, "SPECLOCK.md");
   fs.writeFileSync(filePath, mdContent);
@@ -824,6 +841,34 @@ export function guardFile(root, relativeFilePath, lockText) {
   return { success: true };
 }
 
+// --- Package.json marker injection (makes Bolt.new auto-discover SpecLock) ---
+
+export function injectPackageJsonMarker(root) {
+  const pkgPath = path.join(root, "package.json");
+  if (!fs.existsSync(pkgPath)) {
+    return { success: false, error: "No package.json found in project root." };
+  }
+
+  try {
+    const raw = fs.readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(raw);
+
+    // Add speclock marker
+    pkg.speclock = {
+      active: true,
+      rules: "IMPORTANT: Read SPECLOCK.md before making ANY changes to this project. Read .speclock/context/latest.md for project memory, goals, locks, and decisions. Run 'npx speclock check' before modifying locked files.",
+    };
+
+    // Write back with same formatting
+    const indent = raw.match(/^(\s+)/m)?.[1] || "  ";
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + "\n");
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, error: `Failed to modify package.json: ${err.message}` };
+  }
+}
+
 export function unguardFile(root, relativeFilePath) {
   const fullPath = path.join(root, relativeFilePath);
   if (!fs.existsSync(fullPath)) {