kracked-core 1.5.1 → 1.6.1

package/README.md

@@ -47,7 +47,11 @@ It's plain markdown files. You can read them, edit them, commit them to git, and
 npx kracked-core init
 ```
 
-The wizard asks a few questions — name your agent, is this a new or existing project, which editor you use — and writes the files. Hold Enter through it and you'll get a sane setup.
+The wizard asks a few questions — name your agent, new or existing project, which editor you use —
+and writes the files. Pressing Enter through it gives you a working setup.
+
+**Existing codebase?** It scans your repo and drafts the memory from what it finds.
+**Starting fresh?** It asks what you're building and what stack, so your agent knows from day one.
 
 **Full support** (memory + all five commands):
 **Antigravity** · **Claude Code** · **Kilo Code** (VS Code) · **Roo Code** (VS Code)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kracked-core",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "Zero-dependency memory & workflow installer for AI coding agents — global identity, project memory, and skills that survive session restarts.",
   "type": "module",
   "bin": {

package/src/scaffold.mjs

@@ -80,6 +80,19 @@ async function writeFileWithConflictCheck(destPath, content, ask, report) {
  * 'skip' | 'overwrite' | 'alongside'.
  * `report(entry)` is called once per file, for the wizard's final summary.
  */
+/**
+ * Drop the illustrative example entries from a freshly-written memory file.
+ * They exist to show the format, but left in place they sit alongside the
+ * user's real lessons forever and make the index untrustworthy.
+ */
+function stripExamples(content) {
+  return content
+    .split('\n')
+    .filter((line) => !/^[-|]\s*\[?(YYYY-MM-DD|\d{4}-\d{2}-\d{2})\]?\s*(todo-app|my-blog|<project>)/.test(line))
+    .filter((line) => !/^\|\s*(todo-app|my-blog)\s*\|/.test(line))
+    .join('\n');
+}
+
 export async function writeGlobalMemory({ tokens, ask, report }) {
   const globalDir = path.join(os.homedir(), '.kracked');
   // projects.md is excluded here — it's a running registry appended to by
@@ -88,7 +101,7 @@ export async function writeGlobalMemory({ tokens, ask, report }) {
 
   for (const file of files) {
     const destPath = path.join(globalDir, file);
-    const content = applyTokens(readTemplate(`global/${file}`), tokens);
+    const content = stripExamples(applyTokens(readTemplate(`global/${file}`), tokens));
     await writeFileWithConflictCheck(destPath, content, ask, report);
   }
 }
@@ -124,10 +137,13 @@ export function registerProject({ tokens }) {
   const lines = content.split('\n');
   const isDivider = (l) => /^\|[\s|:-]+\|?\s*$/.test(l);
 
-  // Find the table's divider row (|---|---|), then insert after the last data
-  // row that follows it. Anchoring on the divider matters: without it, a table
-  // whose only row is the header inserts ABOVE the divider and breaks the table.
-  const dividerIdx = lines.findIndex(isDivider);
+  // Anchor on the Registry heading first — a table-looking line elsewhere in the
+  // doc (an example, a fenced snippet) would otherwise capture the insert and
+  // produce a second, malformed table.
+  const registryIdx = lines.findIndex((l) => /^##\s+Registry\s*$/i.test(l));
+  const searchFrom = registryIdx >= 0 ? registryIdx : 0;
+  const rel = lines.slice(searchFrom).findIndex(isDivider);
+  const dividerIdx = rel >= 0 ? searchFrom + rel : -1;
 
   if (dividerIdx >= 0) {
     let insertAt = dividerIdx;

package/src/wizard.mjs

@@ -196,6 +196,7 @@ async function wizardFlow() {
   let projectMode = null; // 'new' | 'existing'
   let stackLine = 'unknown — not auto-detected';
   let projectSummary = null;
+  let projectPitch = '';
 
   if (setUpProject) {
     const pathAnswer = await input('Project directory?', '.');
@@ -250,6 +251,24 @@ async function wizardFlow() {
       classification === 'existing' ? 0 : 1
     );
 
+    if (projectMode === 'new') {
+      // Nothing to scan, so ask instead — otherwise the agent boots knowing
+      // nothing about what's being built, which is the problem this package
+      // exists to solve. Both skippable with Enter.
+      stdout.write('\n  Two quick questions so your agent knows what it\'s working on.\n');
+      stdout.write(`  ${c_dim('Press Enter to skip either one.')}\n\n`);
+
+      projectPitch = sanitizeScanned(
+        await input('What are you building? (one line)', ''),
+        200
+      );
+      const statedStack = sanitizeScanned(
+        await input('What stack? (e.g. Next.js + Supabase)', ''),
+        80
+      );
+      if (statedStack) stackLine = statedStack;
+    }
+
     if (projectMode === 'existing') {
       if (!fs.existsSync(projectDir)) {
         stdout.write(`\n  ${projectDir} doesn't exist yet — nothing to scan. Treating as new.\n`);
@@ -333,6 +352,9 @@ async function wizardFlow() {
     DATE: isoDate(),
     STACK: stackLine,
     RUN_COMMANDS: runCommandsBlock(projectSummary),
+    PITCH: projectPitch
+      ? projectPitch
+      : '_(Add a sentence or two here on what this project actually does.)_',
   };
 
   stdout.write('\nWriting files...\n');

package/templates/global/projects.md

@@ -4,13 +4,7 @@ Registry of every project {{USER_NAME}} is working on. Each row points to the pr
 `.kracked/` folder, where the real detail (stack, conventions, session state) lives. This file
 only tracks what exists and where — never project-specific truth.
 
-## Format
-
-```
-| Project | Path | Stack | Status |
-```
-
-- **Status** is one of: `active`, `paused`, `done`.
+**Status** is one of: `active`, `paused`, `done`.
 
 ## Registry
 

package/templates/project/project.md

@@ -11,7 +11,7 @@ here.
 - **Stack:** {{STACK}}
 - **Created:** {{DATE}}
 
-_(Add a sentence or two here on what this project actually does, once there's something to say.)_
+{{PITCH}}
 
 ## Conventions