stella-protocol 0.4.0 → 0.4.2

package/.claude-plugin/marketplace.json

@@ -17,7 +17,7 @@
       "name": "stella-protocol",
       "source": "./",
       "description": "PM-first AI development protocol with satellite agents, phase governance, and built-in scope/veto enforcement.",
-      "version": "0.3.0",
+      "version": "0.4.2",
       "author": {
         "name": "Aditya Uttama"
       },

package/cli/index.js

@@ -17,24 +17,42 @@ program
   .command('install')
   .description('Install Stella Protocol skills and initialize Punk Records')
   .action(async () => {
-    const { install } = require('./install');
-    await install();
+    try {
+      const { install } = require('./install');
+      await install();
+    } catch (err) {
+      const chalk = require('chalk');
+      console.error(chalk.red('Install failed:'), err.message);
+      process.exit(1);
+    }
   });
 
 program
   .command('init')
   .description('Initialize Punk Records (brain/) in the current project')
   .action(async () => {
-    const { init } = require('./init');
-    await init();
+    try {
+      const { init } = require('./init');
+      await init();
+    } catch (err) {
+      const chalk = require('chalk');
+      console.error(chalk.red('Init failed:'), err.message);
+      process.exit(1);
+    }
   });
 
 program
   .command('status')
   .description('Show current project status from Punk Records')
   .action(async () => {
-    const { status } = require('./status');
-    await status();
+    try {
+      const { status } = require('./status');
+      await status();
+    } catch (err) {
+      const chalk = require('chalk');
+      console.error(chalk.red('Status failed:'), err.message);
+      process.exit(1);
+    }
   });
 
 program.parse();

package/cli/init.js

@@ -7,6 +7,7 @@ const { intro, outro, spinner } = require('@clack/prompts');
 const chalk = require('chalk');
 
 async function init() {
+  try {
   intro(chalk.bold('Punk Records') + chalk.dim(' — Initialize project brain'));
 
   const packageDir = path.resolve(__dirname, '..');
@@ -37,11 +38,15 @@ async function init() {
   const logPosePath = path.join(brainTarget, 'log-pose.md');
   const logPose = await fs.readFile(logPosePath, 'utf-8');
   const projectName = path.basename(process.cwd());
-  await fs.writeFile(logPosePath, logPose.replace('{project-name}', projectName));
+  const today = new Date().toISOString().split('T')[0];
+  await fs.writeFile(logPosePath, logPose.replace('{project-name}', projectName).replace('YYYY-MM-DD', today));
 
   s.stop('Punk Records initialized');
 
   outro(chalk.green('brain/ is ready.') + ' Files: log-pose.md, architecture.md, vivre-cards.md, ideas.md');
+  } catch (err) {
+    outro(chalk.red('Initialization failed: ') + err.message);
+  }
 }
 
 module.exports = { init };

package/cli/install.js

@@ -52,6 +52,7 @@ function getSkillsDir(tool, scope) {
 }
 
 async function install() {
+  try {
   intro(chalk.bold('THE STELLA PROTOCOL') + chalk.dim(' — One mind, many satellites.'));
 
   // Detect AI tool
@@ -102,6 +103,10 @@ async function install() {
   for (const skill of SKILLS) {
     const src = path.join(skillsSource, skill);
     const dest = path.join(skillsTarget, skill);
+    if (!fs.existsSync(src)) {
+      console.warn(chalk.yellow(`  ⚠ Skill "${skill}" not found at ${src} — skipped`));
+      continue;
+    }
     await fs.copy(src, dest, { overwrite: true });
   }
 
@@ -130,7 +135,8 @@ async function install() {
     const logPosePath = path.join(brainTarget, 'log-pose.md');
     const logPose = await fs.readFile(logPosePath, 'utf-8');
     const projectName = path.basename(process.cwd());
-    await fs.writeFile(logPosePath, logPose.replace('{project-name}', projectName));
+    const today = new Date().toISOString().split('T')[0];
+    await fs.writeFile(logPosePath, logPose.replace('{project-name}', projectName).replace('YYYY-MM-DD', today));
 
     brainS.stop(`Punk Records initialized at ${chalk.dim(brainTarget)}`);
   }
@@ -168,6 +174,9 @@ async function install() {
   }
 
   outro(chalk.green('Ready.') + ' Start by telling your AI what you want to build.');
+  } catch (err) {
+    outro(chalk.red('Installation failed: ') + err.message);
+  }
 }
 
 module.exports = { install };

package/cli/status.js

@@ -6,6 +6,7 @@ const fs = require('fs-extra');
 const chalk = require('chalk');
 
 async function status() {
+  try {
   const brainDir = path.join(process.cwd(), 'brain');
   const logPosePath = path.join(brainDir, 'log-pose.md');
 
@@ -17,8 +18,8 @@ async function status() {
 
   const content = await fs.readFile(logPosePath, 'utf-8');
 
-  // Parse frontmatter
-  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  // Parse frontmatter (strict: opening --- must be first line, closing --- must be on its own line)
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---(?:\n|$)/);
   if (fmMatch) {
     const fm = fmMatch[1];
     const lines = fm.split('\n').filter(Boolean);
@@ -39,6 +40,9 @@ async function status() {
   // Print body (skip frontmatter)
   const body = content.replace(/^---\n[\s\S]*?\n---\n*/, '');
   console.log(body);
+  } catch (err) {
+    console.error(chalk.red('Status check failed:'), err.message);
+  }
 }
 
 module.exports = { status };

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "stella-protocol",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "PM-first AI development protocol. One mind, many satellites.",
+  "scripts": {
+    "test": "echo \"No tests yet — see brain/test-plan.md for manual QA checklist\"",
+    "status": "node cli/index.js status"
+  },
   "bin": {
-    "stella": "cli/index.js"
+    "stella": "cli/index.js",
+    "stella-protocol": "cli/index.js"
   },
   "files": [
     "protocol/",

package/protocol/governance/cipher-pol.md

@@ -25,7 +25,7 @@ Unlike a review you invoke, Cipher Pol is **always active**. Every satellite tha
 
 ### INTEL
 - **Drift:** Minor. Within the spirit of the PRD but not explicitly specified.
-- **Action:** Noted in `brain/log-pose.md` under Cipher Pol Report. Work continues.
+- **Action:** Logged to `brain/scope-changes.md`. Work continues.
 - **Example:** Adding a loading spinner not mentioned in the PRD.
 
 ### ALERT
@@ -81,7 +81,7 @@ When any satellite creates a new file, route, page, endpoint, or component durin
 Drift: New [type] created — [path/name]
 PRD says: [relevant scope reference]
 Classification: [INTEL / ALERT / INTERCEPT]
-Action: Logged to vivre-cards.md
+Action: Logged to scope-changes.md
 ```
 
 This applies to:
@@ -96,15 +96,27 @@ Minor implementation files (utilities, helpers, config) do not trigger Cipher Po
 
 ## Logging — MANDATORY
 
-**ALL scope additions — even approved ones — MUST be logged to `brain/vivre-cards.md`** with the prefix "Scope addition:" in the title. This creates an audit trail of how scope evolved during the project.
+**ALL scope drift — even approved additions — MUST be logged to `brain/scope-changes.md`** immediately. This is the primary audit trail of how scope evolved during the project.
 
-Format:
+Format for `brain/scope-changes.md`:
 ```markdown
-### [YYYY-MM-DD] Scope addition: [Description]
+### [YYYY-MM-DD] [Feature/File Name]
+- **File:** [path to new file]
+- **Classification:** INTEL | ALERT | INTERCEPT
+- **Reason:** [why this was needed]
+- **Requested by:** Stella | Agent
+- **Reviewed:** no
+```
+
+**Decision records go to `brain/vivre-cards.md`** — when Stella approves, rejects, or amends scope based on a Cipher Pol flag, log that decision (not the drift itself) to vivre-cards.md with the prefix "Scope decision:" in the title.
+
+Format for `brain/vivre-cards.md` (decisions only):
+```markdown
+### [YYYY-MM-DD] Scope decision: [Description]
 **Phase:** BUILD
 **Satellite:** Cipher Pol
 **Severity:** [INTEL / ALERT / INTERCEPT]
-**Added:** [what was added]
+**Change:** [what was added/changed]
 **PRD reference:** [what the PRD says about this area]
 **Decision:** [approved by Stella / rejected / PRD amended]
 ```

package/skills/stella-build/SKILL.md

@@ -214,6 +214,10 @@ Recommendation: [what to do instead]
 
 Never just mention a concern in passing — use the format, log it, make it visible.
 
+## Next Phase
+
+Setelah BUILD selesai (semua P0 features shipped, tested), guide Stella untuk jalankan `stella-review` untuk review checkpoint. / After BUILD is complete (all P0 features shipped, tested), guide Stella to run `stella-review` for a review checkpoint.
+
 ## Communication Style
 - Direct, concise, no filler
 - Proactive — suggest review checkpoints, don't wait to be asked

package/skills/stella-close/SKILL.md

@@ -112,6 +112,10 @@ At the end of CLOSE:
 - `brain/observability-plan.md` → Created (even if monitoring not yet implemented)
 - All documentation complete and current
 
+## Next Phase
+
+Setelah CLOSE selesai (docs complete, version closed), untuk fitur atau project baru, guide Stella untuk jalankan `stella-protocol` (IMU) untuk mulai ideation cycle baru. / After CLOSE is complete (docs done, version closed), for new features or projects, guide Stella to run `stella-protocol` (IMU) to start a new ideation cycle.
+
 ## Communication Style
 - Direct, concise, no filler
 - Proactive — identify gaps in documentation and suggest fixes

package/skills/stella-define/SKILL.md

@@ -240,12 +240,14 @@ You are defining the scope that will be enforced throughout BUILD. Be precise:
 - Acceptance criteria must be testable
 
 ### Buster Call
-Issue warnings when:
+Issue Buster Calls (WARNING severity) when:
 - Requirements contradict each other
 - Scope exceeds what the selected track supports
 - Critical open questions remain unresolved
 - Architecture has fundamental flaws
 
+**Note:** Only BUSTER CALL severity blocks phase transitions. CONCERN and WARNING are advisory — they inform Stella but don't stop work.
+
 **Every Buster Call MUST be logged to `brain/vivre-cards.md` immediately.** Don't just mention it in conversation.
 
 ## Punk Records Updates
@@ -255,6 +257,10 @@ After DEFINE is complete:
 - `brain/log-pose.md` MUST reflect current phase and state
 - `brain/vivre-cards.md` MUST have entries for key decisions made
 
+## Next Phase
+
+Setelah DEFINE selesai (PRD approved, architecture decided), guide Stella untuk jalankan `stella-build` untuk masuk ke fase BUILD. / After DEFINE is complete (PRD approved, architecture decided), guide Stella to run `stella-build` to enter the BUILD phase.
+
 ## Communication Style
 - Direct, concise, no filler
 - Guide through PRD creation via conversation, not template dumps

package/skills/stella-review/SKILL.md

@@ -181,6 +181,10 @@ After review finds issues, proactively guide the fix cycle:
 
 All findings logged to `brain/vivre-cards.md`. Unresolved BUSTER CALL blocks phase transitions.
 
+## Next Phase
+
+Setelah REVIEW selesai (semua findings resolved atau acknowledged), guide Stella untuk jalankan `stella-close` untuk masuk ke fase CLOSE. / After REVIEW is complete (all findings resolved or acknowledged), guide Stella to run `stella-close` to enter the CLOSE phase.
+
 ## Communication Style
 - Direct, concise, no filler
 - Proactive — suggest what to review, don't wait to be asked