@flancer32/skill-adsm-ctx 0.6.0 → 0.7.0
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/CHANGELOG.md +8 -0
- package/README.md +11 -11
- package/package.json +2 -2
- package/skills/adsm-ctx/SKILL.md +5 -3
- package/skills/adsm-ctx/references/context-evolution.md +7 -7
- package/skills/adsm-ctx/references/context-lifecycle.md +2 -2
- package/skills/adsm-ctx/references/document-projections.md +2 -2
- package/skills/adsm-ctx/references/testing-and-verification.md +10 -2
- package/skills/adsm-ctx/templates/AGENTS.md +10 -2
- package/skills/adsm-ctx/templates/ctx/README.md +1 -1
- package/skills/adsm-ctx/templates/ctx/adsm.json +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/architecture/AGENTS.md +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/architecture/behavior.md +4 -4
- package/skills/adsm-ctx/templates/ctx/docs/code/AGENTS.md +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/code/testing.md +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/environment/AGENTS.md +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/filesystem.md +1 -1
- package/skills/adsm-ctx/templates/ctx/docs/product/AGENTS.md +1 -1
- package/src/Shared/Constants.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this package are documented in this file.
|
|
4
4
|
|
|
5
|
+
## 0.7.0 — 2026-11-05
|
|
6
|
+
|
|
7
|
+
- Target context schema `0.7`; validate older schema labels as unsupported without changing their contexts. Evolve existing contexts through agent review before updating metadata.
|
|
8
|
+
- Make fresh integration of trusted first-party dependencies part of the Rapid Evolution default, subject to accepted security, reproducibility, offline, and deployment requirements.
|
|
9
|
+
- Clarify that failure handling and compatibility require an accepted requirement, demonstrated problem, or meaningful identified risk; align root and architecture templates.
|
|
10
|
+
- Separate bounded product verification from technical test suites and align verification specifications and CI.
|
|
11
|
+
- Clarify Git delivery authorization in generated root instructions and maintain substantive template version dates.
|
|
12
|
+
|
|
5
13
|
## 0.6.0 — 2026-11-04
|
|
6
14
|
|
|
7
15
|
- Use two-part context schema versions aligned to the npm package major and minor; target schema `0.6`, retaining it for package patches.
|
package/README.md
CHANGED
|
@@ -60,7 +60,7 @@ This package does not:
|
|
|
60
60
|
Install the package and then explicitly install its matching agent payload:
|
|
61
61
|
|
|
62
62
|
```sh
|
|
63
|
-
npm install --global
|
|
63
|
+
npm install --global @flancer32/skill-adsm-ctx
|
|
64
64
|
adsm-ctx install-skill "$HOME/.agents/skills"
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -78,11 +78,11 @@ test -f "$HOME/.agents/skills/adsm-ctx/SKILL.md"
|
|
|
78
78
|
To update, update the global npm package and reinstall its payload:
|
|
79
79
|
|
|
80
80
|
```sh
|
|
81
|
-
npm install --global
|
|
81
|
+
npm install --global @flancer32/skill-adsm-ctx
|
|
82
82
|
adsm-ctx install-skill "$HOME/.agents/skills"
|
|
83
83
|
```
|
|
84
84
|
|
|
85
|
-
The npm package is the canonical distribution of both artifacts. Its public `adsm-ctx` launcher runs the package as an explicit TeqFW host; the `install-skill` command copies the version-matched `skills/adsm-ctx/` bundle. Do not copy only `SKILL.md` manually: the payload also needs its references and templates.
|
|
85
|
+
The public npm registry package is the canonical distribution of both artifacts and does not require GitHub SSH access. Its public `adsm-ctx` launcher runs the package as an explicit TeqFW host; the `install-skill` command copies the version-matched `skills/adsm-ctx/` bundle. Do not copy only `SKILL.md` manually: the payload also needs its references and templates.
|
|
86
86
|
|
|
87
87
|
For a project-pinned CI or team workflow, install the package locally and invoke the same public launcher with npm:
|
|
88
88
|
|
|
@@ -135,7 +135,7 @@ teq --host @flancer32/skill-adsm-ctx adsm-ctx:validate .
|
|
|
135
135
|
|
|
136
136
|
### `init`
|
|
137
137
|
|
|
138
|
-
Creates the minimal ADSM-compatible context structure, starter documents, and `ctx/adsm.json` metadata. Schema `0.
|
|
138
|
+
Creates the minimal ADSM-compatible context structure, starter documents, and `ctx/adsm.json` metadata. Schema `0.7` creates all five documentation directories, including `ctx/docs/verification/AGENTS.md`, without empty target categories or placeholder specifications.
|
|
139
139
|
|
|
140
140
|
### `design`
|
|
141
141
|
|
|
@@ -159,7 +159,7 @@ The default compression corpus is `ctx/docs/`. Operational context such as `ctx/
|
|
|
159
159
|
|
|
160
160
|
### Agent-driven evolution
|
|
161
161
|
|
|
162
|
-
Use [the skill evolution procedure](skills/adsm-ctx/references/context-evolution.md) for existing contexts, including unknown historical states. The agent follows discover → interpret → compare → plan → evolve → validate → finalize, preserving accepted meaning and semantic skins. Humans decide changes to accepted meaning and authority. CLI `validate` supplies deterministic findings; there is no evolution command or automatic schema promotion. The agent records target schema `0.
|
|
162
|
+
Use [the skill evolution procedure](skills/adsm-ctx/references/context-evolution.md) for existing contexts, including unknown historical states. The agent follows discover → interpret → compare → plan → evolve → validate → finalize, preserving accepted meaning and semantic skins. Humans decide changes to accepted meaning and authority. CLI `validate` supplies deterministic findings; there is no evolution command or automatic schema promotion. The agent records target schema `0.7` only after structural checks and semantic review succeed, then validates again. The package major and minor match the two-part schema version.
|
|
163
163
|
|
|
164
164
|
## Workflow
|
|
165
165
|
|
|
@@ -186,7 +186,7 @@ product
|
|
|
186
186
|
|
|
187
187
|
Use the architecture level once product meaning is clear enough to define stable engineering guardrails.
|
|
188
188
|
|
|
189
|
-
`ctx/docs/verification/` is mandatory and cross-cutting in schema `0.
|
|
189
|
+
`ctx/docs/verification/` is mandatory and cross-cutting in schema `0.7`. It is not a fifth declarative level. Its root may contain only `AGENTS.md`; create primary-target categories only when durable specifications exist; place that specification below the category of the declaration it primarily evaluates.
|
|
190
190
|
|
|
191
191
|
The bundled architecture templates expect these top-level documents:
|
|
192
192
|
|
|
@@ -249,7 +249,7 @@ Run the fast local project smoke check (context structure and skill/package conv
|
|
|
249
249
|
npm test
|
|
250
250
|
```
|
|
251
251
|
|
|
252
|
-
Run product verification and the
|
|
252
|
+
Run bounded product verification and the technical suites separately:
|
|
253
253
|
|
|
254
254
|
```sh
|
|
255
255
|
npm run verify
|
|
@@ -258,7 +258,7 @@ npm run test:integration
|
|
|
258
258
|
npm run test:package
|
|
259
259
|
```
|
|
260
260
|
|
|
261
|
-
The smoke check does not establish product conformity or semantic context correctness. The verification specifications under `ctx/docs/verification/` identify the observed contracts and their limits. The package installation scenario uses a temporary installation and may skip locally when its offline dependency cache is unavailable; a skip is not evidence of successful installation.
|
|
261
|
+
Project testing checks technical health and engineering correctness; product verification evaluates observable behavior or properties against accepted declarations using applicable specifications. Test level and mechanism do not determine this distinction. The smoke check does not establish product conformity or semantic context correctness. The verification specifications under `ctx/docs/verification/` identify the observed contracts and their limits. The package installation scenario uses a temporary installation and may skip locally when its offline dependency cache is unavailable; a skip is not evidence of successful installation.
|
|
262
262
|
|
|
263
263
|
## Changelog
|
|
264
264
|
|
|
@@ -274,15 +274,15 @@ Apache-2.0
|
|
|
274
274
|
|
|
275
275
|
## Versioning And Compatibility
|
|
276
276
|
|
|
277
|
-
Package `0.
|
|
277
|
+
Package `0.7.0` targets context schema `0.7`. Schema versions use major.minor; npm package versions use major.minor.patch with matching major and minor. Package patch `0.7.1` retains schema `0.7`; a new minor establishes a new schema target. Changes in context conventions require a new minor.
|
|
278
278
|
|
|
279
|
-
`adsm-ctx --version` identifies the installed npm package. Read `ctx/adsm.json` for a project's schema; `adsm-ctx validate <project-root>` reports recorded and supported schema versions. Compatibility follows supported requirements, not numerical equality. Current validation supports schema `0.
|
|
279
|
+
`adsm-ctx --version` identifies the installed npm package. Read `ctx/adsm.json` for a project's schema; `adsm-ctx validate <project-root>` reports recorded and supported schema versions. Compatibility follows supported requirements, not numerical equality. Current validation supports schema `0.7`; all other versions are unsupported and require investigation.
|
|
280
280
|
|
|
281
281
|
Installing or updating the package and explicitly reinstalling its skill do not promote project metadata. An agent compares actual context with the installed skill's target conventions and evolves directly when needed, preserving project meaning and skins. Humans approve changes to accepted meaning. Only after conformance and semantic review does the agent record the target schema; no intermediate CLI migrations are required.
|
|
282
282
|
|
|
283
283
|
## Continuous Integration
|
|
284
284
|
|
|
285
|
-
GitHub Actions runs `.github/workflows/ci.yaml` for pushes and pull requests to `main`, and on manual dispatch. Ubuntu jobs use Node.js 20 (minimum) and 24 (LTS), run `npm ci`, `npm test`, `npm run verify`, context validation, and `npm pack --dry-run`.
|
|
285
|
+
GitHub Actions runs `.github/workflows/ci.yaml` for pushes and pull requests to `main`, and on manual dispatch. Ubuntu jobs use Node.js 20 (minimum) and 24 (LTS), run `npm ci`, `npm test`, all three technical suites, `npm run verify`, context validation, and `npm pack --dry-run`.
|
|
286
286
|
|
|
287
287
|
Package tests install a real npm archive into an isolated temporary environment, exercise the installed CLI and skill installer, compare the complete payload, and preserve neighboring skills. In CI the installation test uses network-enabled dependency resolution and fails on errors instead of skipping for missing offline cache. Local offline runs may report a skip; that is incomplete installation evidence. CI does not publish packages or prove semantic correctness of project documentation.
|
|
288
288
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@flancer32/skill-adsm-ctx",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"description": "Build and evolve project cognitive context for Agent-Driven Software Management (ADSM).",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
"test:integration": "find test/integration -name '*.test.mjs' -print0 | xargs -0 -r node --test",
|
|
31
31
|
"test:package": "node --test test/package/*.test.mjs",
|
|
32
32
|
"test": "node bin/adsm-ctx.mjs validate . && node --test test/package/skill.test.mjs",
|
|
33
|
-
"verify": "
|
|
33
|
+
"verify": "node --test test/integration/schema-050.test.mjs test/integration/cli-init-validate.test.mjs test/integration/cli-install-skill.test.mjs test/package/installation.test.mjs test/package/skill.test.mjs"
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@teqfw/cli": "^2.2.0",
|
package/skills/adsm-ctx/SKILL.md
CHANGED
|
@@ -11,9 +11,11 @@ Humans own direction, accepted meaning, approval, and accountability. Agents ref
|
|
|
11
11
|
|
|
12
12
|
## Development Policy
|
|
13
13
|
|
|
14
|
-
ADSM defaults to **Rapid Evolution by Default, Reliability by Requirement**. Plan short hypothesis → implementation → execution → feedback cycles around essential functionality. Prefer simple working solutions; add
|
|
14
|
+
ADSM defaults to **Rapid Evolution by Default, Reliability by Requirement**. Plan short hypothesis → implementation → execution → feedback cycles around essential functionality. Prefer simple working solutions; add retries, fallbacks, recovery systems, migrations, compatibility layers, or other defensive machinery only for accepted requirements, demonstrated problems, or meaningful identified risks. Fail fast and visibly on unexpected conditions and contract violations rather than hiding them with speculative retries, repairs, or fallbacks.
|
|
15
15
|
|
|
16
|
-
Accepted cognitive context defines the target; code and tests converge on it, and historical behavior is not independent architectural authority. Breaking software interfaces is acceptable by default; retain compatibility, migrations, or legacy layers only
|
|
16
|
+
Accepted cognitive context defines the target; code and tests converge on it, and historical behavior is not independent architectural authority. Breaking software interfaces is acceptable by default; retain compatibility, migrations, or legacy layers only for accepted requirements, demonstrated problems, or meaningful identified risks. Preserve decisions explaining accepted and rejected directions. Verify the happy path and essential contracts with sufficient fast feedback; add regression coverage and stronger checks for observed defects, meaningful risks, or explicit requirements.
|
|
17
|
+
|
|
18
|
+
Fresh integration of trusted, actively developed first-party dependencies is inherited from this default without separate opt-in to expose cross-package incompatibilities early. Accepted requirements or human instructions can override it, including for secure, reproducible, offline, or production use. Investigate failures and fix the responsible contract or implementation instead of masking them. See [testing and verification](references/testing-and-verification.md#fresh-first-party-integration) for applicability and npm details.
|
|
17
19
|
|
|
18
20
|
Humans decide acceptable risks and reliability guarantees; project-specific accepted context can strengthen or replace this default. Never silently compromise security, integrity, or accepted invariants. This software compatibility default does not authorize rewriting consumer contexts or bypassing context-schema evolution and human approval.
|
|
19
21
|
|
|
@@ -61,7 +63,7 @@ The existing context supplies accepted project meaning; this installed skill sup
|
|
|
61
63
|
|
|
62
64
|
Finish with explicit validation results, Verification Layer structure and specification presence when relevant, specialization gaps, human decisions, and any preserved project-specific content. Use `templates/AGENTS.md` and `templates/ctx/` for initialization; use skill `assets/` only for authorized agent-guided document or report work.
|
|
63
65
|
|
|
64
|
-
The current target is schema `0.
|
|
66
|
+
The current target is schema `0.7`. The npm package major and minor match this two-part schema version; package patches retain the same schema. Package updates and context evolution remain separate. Inspect project metadata and actual conformance against this installed skill; never infer compatibility or promote metadata from package-version equality. See [context evolution](references/context-evolution.md) for the decision procedure.
|
|
65
67
|
|
|
66
68
|
## Resource Ownership
|
|
67
69
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Agent-Driven Context Evolution
|
|
2
2
|
|
|
3
3
|
- Path: `skills/adsm-ctx/references/context-evolution.md`
|
|
4
|
-
- Changed: `
|
|
4
|
+
- Changed: `20261105`
|
|
5
5
|
|
|
6
6
|
Evolution brings an existing cognitive context into conformance with the installed skill's target conventions through agent inspection and reasoning. The starting point is the actual context, not an assumed version-to-version file transformation. Use this procedure for methodology, organization, authority relationships, projection rules, and schema changes, including contexts predating known schema versions. Evolution is a skill-guided agent activity and has no CLI command.
|
|
7
7
|
|
|
@@ -9,11 +9,11 @@ Apply the skill's Rapid Evolution default to planning and verification: work tow
|
|
|
9
9
|
|
|
10
10
|
## Target And Responsibilities
|
|
11
11
|
|
|
12
|
-
The current target is context schema `adsm-context` version `0.
|
|
12
|
+
The current target is context schema `adsm-context` version `0.7`, matching the npm package major and minor. Require five documentation directories: `product/`, `architecture/`, `environment/`, `code/`, and `verification/`, each with `AGENTS.md`. Exactly four form the ordered hierarchy product → architecture → environment → code. The cross-cutting verification root may contain only `AGENTS.md`; create primary-target categories only for actual durable specifications. Keep specifications distinct from observations, evidence records, and operational feedback state. Use [document-projections.md](document-projections.md) for projection, links, assets, and capacity conventions.
|
|
13
13
|
|
|
14
14
|
The skill defines target conventions and this procedure. The agent interprets the existing context, compares, applies authorized changes, checks consistency, and finalizes metadata. CLI `init` creates missing baseline files, including verification routing and initial metadata, without overwriting existing files. CLI `validate` is read-only: it never creates verification files, replaces documents, changes skins, or promotes metadata. There is no CLI evolution command. Humans control accepted project meaning, authority, and approval of changes beyond the agent's existing authorization.
|
|
15
15
|
|
|
16
|
-
For schema `0.
|
|
16
|
+
For schema `0.7`, assess the rapid-evolution development default, inherited fresh first-party integration, requirement-driven reliability, and the distinction between project testing and bounded product verification against the actual project instructions, testing documentation, and accepted decisions. Existing `0.6` contexts require this review as well; preserve explicitly accepted reproducibility and security requirements. The default is replaceable by project policy; do not override a project's accepted policy or copy template text blindly. Reconcile testing guidance with the project's ecosystem and existing requirements, with human decisions for changes to accepted meaning.
|
|
17
17
|
|
|
18
18
|
## 1. Discover
|
|
19
19
|
|
|
@@ -27,7 +27,7 @@ Locate authoritative product intent, architecture decisions and rationale, envir
|
|
|
27
27
|
|
|
28
28
|
## 3. Compare
|
|
29
29
|
|
|
30
|
-
Compare actual structure and meaning with current target conventions, even when the recorded version is unknown or already `0.
|
|
30
|
+
Compare actual structure and meaning with current target conventions, even when the recorded version is unknown or already `0.7`. Inventory structural, documentary, projection, and authority differences. Run `adsm-ctx validate <project-root>` and distinguish mechanical findings from semantic inconsistencies. A current version is not proof of conformance; green structure does not establish semantic correctness, verification coverage, or runtime correctness.
|
|
31
31
|
|
|
32
32
|
For example, `0.1.0` and `0.2.0` may lack `verification/AGENTS.md` or describe verification as optional. Inspect their actual documents instead of applying a fixed replacement. Unknown historical layouts require investigation and explicit reporting of what cannot yet be interpreted safely.
|
|
33
33
|
|
|
@@ -37,7 +37,7 @@ Classify proposed changes as structural, editorial, semantic, or requiring human
|
|
|
37
37
|
|
|
38
38
|
## 5. Evolve
|
|
39
39
|
|
|
40
|
-
Apply authorized changes in documentation dependency order. Add missing required boundaries from canonical templates only after inspecting the destination; adapt routing to the actual project instead of replacing custom instructions. For `0.
|
|
40
|
+
Apply authorized changes in documentation dependency order. Add missing required boundaries from canonical templates only after inspecting the destination; adapt routing to the actual project instead of replacing custom instructions. For `0.7`, add missing `verification/AGENTS.md`, update the documentation Level Map, and reconcile optional-adoption wording with accepted declarations and skins. Preserve existing specifications and project directories; create no placeholder specifications or empty target categories.
|
|
41
41
|
|
|
42
42
|
Restructure or clarify only within authorization. Preserve intent, constraints, rationale, history, and projection meaning. Update linked consumers when moving a document and preserve one canonical authority home. Use deterministic helpers only for bounded, agent-selected operations; they do not decide semantic changes. Reinspect on partial failure, report completed work and unresolved differences, and preserve the previous schema label while work remains incomplete.
|
|
43
43
|
|
|
@@ -47,13 +47,13 @@ Run deterministic validation and inspect every error and warning. Assess semanti
|
|
|
47
47
|
|
|
48
48
|
## 7. Finalize
|
|
49
49
|
|
|
50
|
-
Only after target structural requirements and semantic consistency are satisfied, update `ctx/adsm.json` to version `0.
|
|
50
|
+
Only after target structural requirements and semantic consistency are satisfied, update `ctx/adsm.json` to version `0.7`, preserving meaningful metadata fields. A version edit records successful evolution; it does not perform it. Do not promote partially evolved contexts. Run validation again against the final metadata; investigate any failure and retain or restore the prior label if conformance is not established. Do not overwrite an unknown future schema based on this package's older target conventions.
|
|
51
51
|
|
|
52
52
|
Report changes and rationale, preserved content, deterministic results, semantic review scope and limits, remaining warnings, human decisions, and relevant Git histories. On a repeat request, compare the actual state again and make only necessary authorized changes. Repeated CLI validation remain read-only regardless of context state.
|
|
53
53
|
|
|
54
54
|
|
|
55
55
|
## Package Updates And Schema Compatibility
|
|
56
56
|
|
|
57
|
-
A package update replaces the npm implementation; explicitly rerun `adsm-ctx install-skill <skills-root>` to replace its bundled agent guidance. This does not change any context schema metadata and does not imply context evolution is required. Schema versions describe accepted context conventions; package versions describe implementation releases. Package `0.
|
|
57
|
+
A package update replaces the npm implementation; explicitly rerun `adsm-ctx install-skill <skills-root>` to replace its bundled agent guidance. This does not change any context schema metadata and does not imply context evolution is required. Schema versions describe accepted context conventions; package versions describe implementation releases. Package `0.7.1` targets schema `0.7` unchanged. Never infer compatibility from numerical equality.
|
|
58
58
|
|
|
59
59
|
Read the current schema from the project's `ctx/adsm.json`; identify this installed skill's target from Target Conventions above, not the npm version shown by `adsm-ctx --version`. Compare actual context with those conventions and use `validate` to check recorded and supported schema labels plus structural findings. If already conforming to the same schema, no evolution is needed merely because the package changed. Classify structural repairs separately from semantic changes; use the seven phases above for needed evolution and obtain human approval for changes to accepted meaning or authority. Unsupported labels require investigation; no version-specific migration is provided. Never relabel an older context based solely on package installation.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Context Lifecycle
|
|
2
2
|
|
|
3
3
|
- Path: `skills/adsm-ctx/references/context-lifecycle.md`
|
|
4
|
-
- Changed: `
|
|
4
|
+
- Changed: `20261104`
|
|
5
5
|
|
|
6
6
|
`adsm-ctx` manages six lifecycle modes for project cognitive context.
|
|
7
7
|
|
|
@@ -27,7 +27,7 @@ The lifecycle is iterative. A project may return to `design`, `validate`, `quali
|
|
|
27
27
|
The package-level `adsm-ctx install-skill <skills-root>` command installs the version-matched skill payload into an explicitly supplied agent skills root. After installation or update, run:
|
|
28
28
|
|
|
29
29
|
```sh
|
|
30
|
-
npm install --global
|
|
30
|
+
npm install --global @flancer32/skill-adsm-ctx
|
|
31
31
|
adsm-ctx install-skill "$HOME/.agents/skills"
|
|
32
32
|
```
|
|
33
33
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Documentation Projections
|
|
2
2
|
|
|
3
3
|
- Path: `skills/adsm-ctx/references/document-projections.md`
|
|
4
|
-
- Changed: `
|
|
4
|
+
- Changed: `20261105`
|
|
5
5
|
|
|
6
6
|
Use this reference whenever an agent initializes, designs, validates, audits, compresses, or evolves ADSM documentation under `ctx/docs/`.
|
|
7
7
|
|
|
@@ -124,7 +124,7 @@ Their meanings remain:
|
|
|
124
124
|
|
|
125
125
|
For the distinction between project testing and product verification, evidence limits, and npm command conventions, see [testing-and-verification.md](testing-and-verification.md).
|
|
126
126
|
|
|
127
|
-
Require the block in schema `0.
|
|
127
|
+
Require the block in schema `0.7`, even when it contains only `AGENTS.md`. Its root requires `AGENTS.md`; direct categories are optional `product/`, `architecture/`, `environment/`, and `code/`. Create a category only when a durable specification exists beneath it. Do not initialize empty categories or placeholder specifications.
|
|
128
128
|
|
|
129
129
|
A verification specification has one canonical home selected by its **primary verification target**: the declaration or bounded declaration group whose truth it chiefly evaluates. It may link to secondary declarations, executable tests, monitors, environments, dependencies, and other contexts. Mechanism, test framework, source path, CI job, endpoint, reporting context, and current Responsible Context do not determine placement.
|
|
130
130
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Project Testing And Product Verification
|
|
2
2
|
|
|
3
3
|
- Path: `skills/adsm-ctx/references/testing-and-verification.md`
|
|
4
|
-
- Changed: `
|
|
4
|
+
- Changed: `20261105`
|
|
5
5
|
|
|
6
6
|
Project testing checks technical health and engineering conventions of the project and its artifacts, such as context structure, types, module conventions, dependency boundaries, and packaging. A passing project check is not evidence that the product satisfies all its declared requirements. In particular, structural context validation cannot establish semantic correctness.
|
|
7
7
|
|
|
@@ -9,4 +9,12 @@ Product verification assesses a declared product property or behavior through bo
|
|
|
9
9
|
|
|
10
10
|
Choose checks proportionally to the change and risk. Include focused negative tests when security or failure boundaries change. The same test mechanism can contribute to either concern when its target and evidence are explicit; test level alone does not decide the distinction. Humans and accepted project context determine required guarantees. Projects own their scenarios, mechanisms, and evidence; do not invent them in generic templates.
|
|
11
11
|
|
|
12
|
-
For npm projects, `npm test` should be a very fast local project smoke check: no network, temporary installations, or end-to-end scenarios. Use focused `test:*` commands where useful for other project checks. Use `npm run verify` for product verification and optional `verify:*` commands for selected scopes; document their coverage, prerequisites, skips, and limits. Do not prescribe a universal suite or mandatory end-to-end setup. These are npm conventions, not requirements to use npm in other ecosystems; keep existing contexts intact and evolve project commands only within the authorized scope.
|
|
12
|
+
For npm projects, `npm test` should be a very fast local project smoke check: no network, temporary installations, or end-to-end scenarios. Use focused `test:*` commands where useful for other project checks. Use `npm run verify` for explicitly bounded product verification, not an indiscriminate aggregate of technical suites, and optional `verify:*` commands for selected scopes; document their coverage, prerequisites, skips, and limits. Do not prescribe a universal suite or mandatory end-to-end setup. These are npm conventions, not requirements to use npm in other ecosystems; keep existing contexts intact and evolve project commands only within the authorized scope.
|
|
13
|
+
|
|
14
|
+
## Fresh First-Party Integration
|
|
15
|
+
|
|
16
|
+
Projects inherit this convention from the Rapid Evolution default without separate opt-in: prefer freshly resolved integration of trusted, actively developed first-party libraries to shorten feedback across repositories. Accepted project context and human instructions override this default, including reproducibility, offline, security, integrity, operational, and deployment requirements. It does not prescribe floating third-party dependencies or production and regulated deployments. Releases and deployments may require independently locked, reproducible inputs. Do not rewrite existing consumer repositories without authorization.
|
|
17
|
+
|
|
18
|
+
For applicable npm projects, a dependency such as `"@teqfw/dem-idb": "github:teqfw/dem-idb"` has no ref selector and resolves the repository's default branch on fresh resolution. Avoid maintaining a committed `package-lock.json` by default: set `package-lock=false` in the project `.npmrc` so npm neither consumes nor writes that lockfile, ignore `package-lock.json`, and stop tracking an existing one only as part of an authorized transition. Check for other lock mechanisms, such as `npm-shrinkwrap.json`, and explicit requirements before assuming resolution is fresh.
|
|
19
|
+
|
|
20
|
+
Use clean CI installations with `npm install` for this integration mode; `npm ci` requires a lockfile and installs its frozen graph. An ordinary `npm install` over existing `node_modules` does not guarantee a newer Git revision: explicitly refresh the dependency or use a clean installation when freshness matters. Do not require npm publication for every first-party iteration. Investigate incompatibilities and fix the responsible contract or implementation instead of silently pinning an older revision, masking failures, or adding speculative compatibility layers.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Root Level
|
|
2
2
|
|
|
3
3
|
- Path: `AGENTS.md`
|
|
4
|
-
- Template Version: `
|
|
4
|
+
- Template Version: `20261105`
|
|
5
5
|
- Changed: `YYYYMMDD`
|
|
6
6
|
|
|
7
7
|
## Boundary
|
|
@@ -14,10 +14,18 @@ A task may cover multiple repositories. Coordinate affected contracts and consum
|
|
|
14
14
|
|
|
15
15
|
## Development Policy
|
|
16
16
|
|
|
17
|
-
Default to Rapid Evolution by Default, Reliability by Requirement: deliver the essential happy path for fast feedback, fail visibly on unexpected conditions, and avoid speculative defenses and backward compatibility unless
|
|
17
|
+
Default to Rapid Evolution by Default, Reliability by Requirement: deliver the essential happy path for fast feedback, fail visibly on unexpected conditions, and avoid speculative defenses and backward compatibility unless justified by accepted requirements, demonstrated problems, or meaningful identified risks. Verify essential contracts and increase verification when risk or observed defects justify it. Accepted context defines the target; humans determine acceptable risk and may strengthen or replace this default. Preserve security, integrity, and explicit invariants. Consult the `adsm-ctx` skill for the policy.
|
|
18
|
+
|
|
19
|
+
This default includes fresh integration of trusted, actively developed first-party dependencies without separate opt-in. Accepted requirements or human instructions may override it; preserve required security, integrity, offline operation, and reproducibility, particularly for releases and deployments. Follow the skill's dependency guidance.
|
|
18
20
|
|
|
19
21
|
## Efficient Execution
|
|
20
22
|
|
|
21
23
|
Classify the task before reading context or running checks. Git-only work needs Git-state checks, not product-context scans or tests. For code or context changes, inspect only relevant owners; run deterministic checks chosen by changed responsibility and risk. Capture verbose output outside the model context and inspect logs on failure or when evidence is needed. Report results, omitted coverage, and material risks concisely.
|
|
22
24
|
|
|
23
25
|
Do not modify, replace, delete, or relocate this file without explicit human instruction. Do not read, search, or expose secret-bearing files or credentials; non-secret examples may describe configuration shape. If a secret is accidentally exposed, do not repeat it; notify the human that it should be rotated or revoked.
|
|
26
|
+
|
|
27
|
+
## Git Delivery
|
|
28
|
+
|
|
29
|
+
An explicit task instruction to commit and push authorizes delivery of the verified commit to the named repository and branch, or to its configured upstream when the branch is unspecified. Inspect the worktree, branch, and remote before pushing. If sandbox networking blocks Git, use the normal approved escalation path; do not ask for duplicate authorization.
|
|
30
|
+
|
|
31
|
+
An automated approval rejection is a platform restriction, not evidence that user authorization is missing. Report the specific restriction and request only the approval the gate requires. Keep delivery pending while that approval is required. These instructions do not override platform security or approval controls or applicable repository rules.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Architecture Behavior
|
|
2
2
|
|
|
3
3
|
- Path: `ctx/docs/architecture/behavior.md`
|
|
4
|
-
- Template Version: `
|
|
4
|
+
- Template Version: `20261105`
|
|
5
5
|
- Changed: `YYYYMMDD`
|
|
6
6
|
|
|
7
7
|
## Purpose
|
|
@@ -14,7 +14,7 @@ This document explains how the system works internally, not which product outcom
|
|
|
14
14
|
|
|
15
15
|
Describe the main architectural flows that matter for the system.
|
|
16
16
|
|
|
17
|
-
Examples may include request handling, synchronization, ingestion, supervision, background processing
|
|
17
|
+
Examples may include request handling, synchronization, ingestion, supervision, or background processing when relevant.
|
|
18
18
|
|
|
19
19
|
Do not rewrite product use cases here.
|
|
20
20
|
|
|
@@ -27,9 +27,9 @@ For each major flow, clarify:
|
|
|
27
27
|
- where important decisions are made;
|
|
28
28
|
- where the flow ends or commits durable change.
|
|
29
29
|
|
|
30
|
-
## Failure
|
|
30
|
+
## Failure Behavior
|
|
31
31
|
|
|
32
|
-
Describe
|
|
32
|
+
Describe visible failure behavior and any handling required by accepted requirements, demonstrated problems, or meaningful identified risks. Do not introduce retries, fallback, recovery, or degradation speculatively. Preserve security, integrity, and accepted invariants.
|
|
33
33
|
|
|
34
34
|
## Product Dependency
|
|
35
35
|
|
package/src/Shared/Constants.mjs
CHANGED
|
@@ -9,7 +9,7 @@ export default class Constants {
|
|
|
9
9
|
/** Initializes the supported context constants. */
|
|
10
10
|
constructor() {
|
|
11
11
|
this.CONTEXT_SCHEMA = "adsm-context";
|
|
12
|
-
this.CONTEXT_VERSION = "0.
|
|
12
|
+
this.CONTEXT_VERSION = "0.7";
|
|
13
13
|
this.VERIFICATION_CAPABILITY = "verification-layer";
|
|
14
14
|
this.CONTEXT_CAPABILITIES = Object.freeze([this.VERIFICATION_CAPABILITY]);
|
|
15
15
|
this.VERIFICATION_BLOCK = "verification";
|