changeledger 0.6.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +4 -2
- package/package.json +1 -1
- package/src/contract.mjs +4 -2
- package/templates/contract/core.md +9 -0
package/AGENTS.md
CHANGED
|
@@ -6,8 +6,10 @@ under `.changeledger/changes/`, persistent truth under `.changeledger/specs/`.
|
|
|
6
6
|
<!-- changeledger -->
|
|
7
7
|
> [!IMPORTANT]
|
|
8
8
|
> This repo uses **ChangeLedger**. Before creating or modifying files, run
|
|
9
|
-
> `changeledger context
|
|
10
|
-
> If the
|
|
9
|
+
> `changeledger context`, read its complete output, and follow it.
|
|
10
|
+
> If the output is truncated/incomplete, stop and restore complete context before
|
|
11
|
+
> proceeding. If the command is unavailable, stop and restore/install
|
|
12
|
+
> ChangeLedger; do not proceed from memory.
|
|
11
13
|
|
|
12
14
|
The canonical ChangeLedger contract is split into task-focused fragments under
|
|
13
15
|
[`templates/contract/`](templates/contract/). The deterministic
|
package/package.json
CHANGED
package/src/contract.mjs
CHANGED
|
@@ -37,8 +37,10 @@ const LEGACY_CONTRACT_HASHES = new Set([
|
|
|
37
37
|
export const REFERENCE = `${MARKER}
|
|
38
38
|
> [!IMPORTANT]
|
|
39
39
|
> This repo uses **ChangeLedger**. Before creating or modifying files, run
|
|
40
|
-
> \`changeledger context
|
|
41
|
-
> If the
|
|
40
|
+
> \`changeledger context\`, read its complete output, and follow it.
|
|
41
|
+
> If the output is truncated/incomplete, stop and restore complete context before
|
|
42
|
+
> proceeding. If the command is unavailable, stop and restore/install
|
|
43
|
+
> ChangeLedger; do not proceed from memory.
|
|
42
44
|
`;
|
|
43
45
|
|
|
44
46
|
export const contractLink = (changeledgerDir) => path.join(changeledgerDir, 'AGENTS.md');
|
|
@@ -5,6 +5,10 @@ reflection. Work is planned and documented before code is written.
|
|
|
5
5
|
|
|
6
6
|
## Non-negotiable fast path
|
|
7
7
|
|
|
8
|
+
Running `changeledger context` is discovery, not compliance by itself. Read the
|
|
9
|
+
complete output and follow the current mode. If the output is truncated or
|
|
10
|
+
incomplete, stop and restore complete context before creating or modifying files.
|
|
11
|
+
|
|
8
12
|
1. Work starts with conversation. Read-only investigation may clarify a request,
|
|
9
13
|
but create no change or implementation artifact until there is enough clarity
|
|
10
14
|
to document faithfully **and** the human explicitly authorizes documentation. A direct request such
|
|
@@ -22,6 +26,11 @@ reflection. Work is planned and documented before code is written.
|
|
|
22
26
|
8. After human acceptance, graduate persistent truth or record an explicit skip,
|
|
23
27
|
then archive the done change.
|
|
24
28
|
|
|
29
|
+
If no approved or in-progress change applies, do not silently edit repository
|
|
30
|
+
files. Create or update a change, or ask the human whether a purely operational,
|
|
31
|
+
reversible edit with no persistent truth or observable behavior change should be
|
|
32
|
+
done directly. If unsure, document it in ChangeLedger.
|
|
33
|
+
|
|
25
34
|
Humans consume changes in `changeledger view`; write for the rendered view.
|
|
26
35
|
|
|
27
36
|
## Lifecycle
|