changeledger 0.6.0 → 0.6.2

package/AGENTS.md

@@ -6,8 +6,11 @@ under `.changeledger/changes/`, persistent truth under `.changeledger/specs/`.
 <!-- changeledger -->
 > [!IMPORTANT]
 > This repo uses **ChangeLedger**. Before creating or modifying files, run
-> `changeledger context` (or `changeledger context <change-id>`) and follow its output.
-> If the command is unavailable, stop and restore/install ChangeLedger; do not proceed from memory.
+> `changeledger context` directly, read its complete output, and follow it.
+> Do not pipe, filter, summarize, limit, or truncate the output before reading it.
+> If the output is truncated/incomplete, stop and restore complete context before
+> proceeding. If the command is unavailable, stop and restore/install
+> ChangeLedger; do not proceed from memory.
 
 The canonical ChangeLedger contract is split into task-focused fragments under
 [`templates/contract/`](templates/contract/). The deterministic

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "changeledger",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Turn conversations into buildable changes.",
   "type": "module",
   "bin": {

package/src/commands/context.mjs

@@ -7,28 +7,32 @@ import { resolveChange } from '../repo.mjs';
 
 const MODES = ['implement', 'review', 'spec', 'release'];
 const MODE_CONTEXT = {
-  implement: ['core', 'implement', 'readiness'],
-  review: ['core', 'review'],
-  spec: ['core', 'spec', 'readiness'],
-  release: ['core', 'release'],
+  implement: ['implement', 'readiness'],
+  review: ['review'],
+  spec: ['spec', 'readiness'],
+  release: ['release'],
 };
 const STATUS_CONTEXT = {
   draft: { mode: 'spec', fragments: MODE_CONTEXT.spec },
   approved: { mode: 'implement', fragments: MODE_CONTEXT.implement },
   'in-progress': { mode: 'implement', fragments: MODE_CONTEXT.implement },
-  'in-review': { mode: 'review', fragments: ['core', 'review'] },
-  blocked: { mode: 'blocked', fragments: ['core', 'blocked'] },
-  'in-validation': { mode: 'validation', fragments: ['core', 'validation'] },
-  done: { mode: 'close', fragments: ['core', 'close'] },
-  discarded: { mode: 'discarded', fragments: ['core', 'discarded'] },
+  'in-review': { mode: 'review', fragments: MODE_CONTEXT.review },
+  blocked: { mode: 'blocked', fragments: ['blocked'] },
+  'in-validation': { mode: 'validation', fragments: ['validation'] },
+  done: { mode: 'close', fragments: ['close'] },
+  discarded: { mode: 'discarded', fragments: ['discarded'] },
 };
+const INCREMENTAL_NOTICE = `This incremental context extends the complete core context already read.
+If the complete base output has not been read, stop and run \`changeledger context\` directly before proceeding.`;
 
 function fragment(name) {
   return fs.readFileSync(path.join(contractTemplatesDir, `${name}.md`), 'utf8').trim();
 }
 
-function compose(mode, fragments, changeText) {
-  const sections = [`Mode: ${mode}`, ...fragments.map(fragment)];
+function compose(mode, fragments, changeText, incremental = true) {
+  const sections = [`Mode: ${mode}`];
+  if (incremental) sections.push(INCREMENTAL_NOTICE);
+  sections.push(...fragments.map(fragment));
   if (changeText) sections.push('---\n\n# Selected change\n', changeText.trim());
   return `${sections.join('\n\n')}\n`;
 }
@@ -41,7 +45,7 @@ function requireRepo(cwd) {
 
 export function buildContext(input, cwd = process.cwd()) {
   requireRepo(cwd);
-  if (!input) return compose('core', ['core']);
+  if (!input) return compose('core', ['core'], undefined, false);
   if (MODES.includes(input)) return compose(input, MODE_CONTEXT[input]);
 
   let resolved;

package/src/contract.mjs

@@ -37,8 +37,11 @@ const LEGACY_CONTRACT_HASHES = new Set([
 export const REFERENCE = `${MARKER}
 > [!IMPORTANT]
 > This repo uses **ChangeLedger**. Before creating or modifying files, run
-> \`changeledger context\` (or \`changeledger context <change-id>\`) and follow its output.
-> If the command is unavailable, stop and restore/install ChangeLedger; do not proceed from memory.
+> \`changeledger context\` directly, read its complete output, and follow it.
+> Do not pipe, filter, summarize, limit, or truncate the output before reading it.
+> If the output is truncated/incomplete, stop and restore complete context before
+> proceeding. If the command is unavailable, stop and restore/install
+> ChangeLedger; do not proceed from memory.
 `;
 
 export const contractLink = (changeledgerDir) => path.join(changeledgerDir, 'AGENTS.md');

package/templates/contract/core.md

@@ -5,6 +5,13 @@ reflection. Work is planned and documented before code is written.
 
 ## Non-negotiable fast path
 
+Running `changeledger context` is discovery, not compliance by itself. Run it
+directly, without piping, filtering, summarizing, limiting or truncating output
+before reading it. Read the complete output and follow the current mode. If the
+output is truncated or incomplete, including through tools such as `head`,
+`tail`, `sed` or `grep`, stop and restore complete context before creating or
+modifying files.
+
 1. Work starts with conversation. Read-only investigation may clarify a request,
    but create no change or implementation artifact until there is enough clarity
    to document faithfully **and** the human explicitly authorizes documentation. A direct request such
@@ -22,6 +29,11 @@ reflection. Work is planned and documented before code is written.
 8. After human acceptance, graduate persistent truth or record an explicit skip,
    then archive the done change.
 
+If no approved or in-progress change applies, do not silently edit repository
+files. Create or update a change, or ask the human whether a purely operational,
+reversible edit with no persistent truth or observable behavior change should be
+done directly. If unsure, document it in ChangeLedger.
+
 Humans consume changes in `changeledger view`; write for the rendered view.
 
 ## Lifecycle
@@ -54,6 +66,9 @@ never reopen.
 
 Valid modes: implement, review, spec, release.
 
+Run these only after reading the complete base output. Each mode and change-id
+context extends the core context already read without repeating it.
+
 - `changeledger context spec`: author or refine a change.
 - `changeledger context implement`: execute an approved change.
 - `changeledger context review`: independently verify completed work.