@flancer32/skill-adsm-ctx 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.7.0 — 2026-11-05
+
+- Target context schema `0.7`; validate older schema labels as unsupported without changing their contexts. Evolve existing contexts through agent review before updating metadata.
+- Make fresh integration of trusted first-party dependencies part of the Rapid Evolution default, subject to accepted security, reproducibility, offline, and deployment requirements.
+- Clarify that failure handling and compatibility require an accepted requirement, demonstrated problem, or meaningful identified risk; align root and architecture templates.
+- Separate bounded product verification from technical test suites and align verification specifications and CI.
+- Clarify Git delivery authorization in generated root instructions and maintain substantive template version dates.
+
+## 0.6.0 — 2026-11-04
+
+- Use two-part context schema versions aligned to the npm package major and minor; target schema `0.6`, retaining it for package patches.
+- Clarify development policy and project testing versus product verification in the skill and initialization templates. Evolve existing contexts through agent inspection and human decisions.
+- Report unsupported schema versions uniformly without automatic migration; preserve context and metadata during validation.
+- Align TeqFW dependencies and JSDoc contracts, and improve repository context navigation.
+
 ## 0.5.0 — 2026-10-24
 
 - Adopt context schema `0.5.0`: require five documentation directories, including the cross-cutting Verification Layer, while preserving four ordered declarative levels. Allow an AGENTS-only verification root without placeholder specifications.

package/README.md

@@ -10,6 +10,8 @@ It manages the lifecycle of project context as its primary object. It does not d
 
 This package is developed according to the [ADSM methodology](http://fly.wiredgeese.com/flancer/leanpub/adsm-en/).
 
+ADSM defaults to **Rapid Evolution by Default, Reliability by Requirement**: deliver essential functionality in short feedback cycles, fail visibly, avoid unrequired compatibility, and verify according to contracts and risk. Humans control acceptable risk and can set a different project policy; accepted context, security, integrity, and explicit invariants remain binding. New projects receive a concise policy in their root `AGENTS.md`; existing projects are not rewritten. See the bundled [skill guidance](skills/adsm-ctx/SKILL.md#development-policy) for details.
+
 The package includes:
 
 - the `adsm-ctx` CLI for lifecycle operations;
@@ -58,7 +60,7 @@ This package does not:
 Install the package and then explicitly install its matching agent payload:
 
 ```sh
-npm install --global git+ssh://git@github.com/flancer32/skill-adsm-ctx.git
+npm install --global @flancer32/skill-adsm-ctx
 adsm-ctx install-skill "$HOME/.agents/skills"
 ```
 
@@ -76,11 +78,11 @@ test -f "$HOME/.agents/skills/adsm-ctx/SKILL.md"
 To update, update the global npm package and reinstall its payload:
 
 ```sh
-npm install --global git+ssh://git@github.com/flancer32/skill-adsm-ctx.git
+npm install --global @flancer32/skill-adsm-ctx
 adsm-ctx install-skill "$HOME/.agents/skills"
 ```
 
-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.
+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.
 
 For a project-pinned CI or team workflow, install the package locally and invoke the same public launcher with npm:
 
@@ -133,7 +135,7 @@ teq --host @flancer32/skill-adsm-ctx adsm-ctx:validate .
 
 ### `init`
 
-Creates the minimal ADSM-compatible context structure, starter documents, and `ctx/adsm.json` metadata. Schema `0.5.0` creates all five documentation directories, including `ctx/docs/verification/AGENTS.md`, without empty target categories or placeholder specifications.
+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.
 
 ### `design`
 
@@ -157,7 +159,7 @@ The default compression corpus is `ctx/docs/`. Operational context such as `ctx/
 
 ### Agent-driven evolution
 
-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.5.0` only after structural checks and semantic review succeed, then validates again. npm versioning remains independent.
+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.
 
 ## Workflow
 
@@ -184,7 +186,7 @@ product
 
 Use the architecture level once product meaning is clear enough to define stable engineering guardrails.
 
-`ctx/docs/verification/` is mandatory and cross-cutting in schema `0.5.0`. 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.
+`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.
 
 The bundled architecture templates expect these top-level documents:
 
@@ -241,12 +243,23 @@ Run the CLI directly from the repository:
 npm exec -- adsm-ctx --help
 ```
 
-Run the tests:
+Run the fast local project smoke check (context structure and skill/package conventions):
 
 ```sh
 npm test
 ```
 
+Run bounded product verification and the technical suites separately:
+
+```sh
+npm run verify
+npm run test:unit
+npm run test:integration
+npm run test:package
+```
+
+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.
+
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for the dated release notes.
@@ -261,15 +274,15 @@ Apache-2.0
 
 ## Versioning And Compatibility
 
-Release `0.5.0` uses npm package `0.5.0` and context schema `0.5.0`. These numbers have independent responsibilities: the package versions CLI, validator, skill, templates, and fixes; the schema versions accepted context conventions. Package `0.5.1` may fix a validator while retaining schema `0.5.0`, requiring no context evolution.
+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.
 
-`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.5.0`; older labels receive evolution guidance and unknown versions require investigation.
+`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.
 
 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.
 
 ## Continuous Integration
 
-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`, context validation, and `npm pack --dry-run`.
+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`.
 
 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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flancer32/skill-adsm-ctx",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Build and evolve project cognitive context for Agent-Driven Software Management (ADSM).",
   "license": "Apache-2.0",
   "type": "module",
@@ -29,7 +29,8 @@
     "test:unit": "find test/unit -name '*.test.mjs' -print0 | xargs -0 -r node --test",
     "test:integration": "find test/integration -name '*.test.mjs' -print0 | xargs -0 -r node --test",
     "test:package": "node --test test/package/*.test.mjs",
-    "test": "npm run test:unit && npm run test:integration && npm run test:package"
+    "test": "node bin/adsm-ctx.mjs validate . && node --test test/package/skill.test.mjs",
+    "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"
   },
   "dependencies": {
     "@teqfw/cli": "^2.2.0",

package/skills/adsm-ctx/SKILL.md

@@ -9,6 +9,16 @@ Manage the lifecycle of an ADSM project cognitive context. Manage generic contex
 
 Humans own direction, accepted meaning, approval, and accountability. Agents refine, check consistency, maintain documentation, and report decisions that require human authority.
 
+## Development Policy
+
+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.
+
+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.
+
+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.
+
+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.
+
 ## Start Here
 
 1. Identify the target repository and the requested lifecycle mode.
@@ -22,7 +32,7 @@ Humans own direction, accepted meaning, approval, and accountability. Agents ref
 | --- | --- |
 | `init` baseline | [context-lifecycle.md](references/context-lifecycle.md); use the `templates/ctx/` baseline. |
 | `design` or new branch | [context-lifecycle.md](references/context-lifecycle.md), [design-questionnaire.md](references/design-questionnaire.md), and [specialized-skills.md](references/specialized-skills.md). |
-| Verification Layer or Software Evolution Loop | [document-projections.md](references/document-projections.md), [context-lifecycle.md](references/context-lifecycle.md), [documentation-quality-audit.md](references/documentation-quality-audit.md), and [specialized-skills.md](references/specialized-skills.md). |
+| Project testing, Verification Layer, or Software Evolution Loop | [testing-and-verification.md](references/testing-and-verification.md), [document-projections.md](references/document-projections.md), [context-lifecycle.md](references/context-lifecycle.md), [documentation-quality-audit.md](references/documentation-quality-audit.md), and [specialized-skills.md](references/specialized-skills.md). |
 | `validate` structure | [context-lifecycle.md](references/context-lifecycle.md), [document-projections.md](references/document-projections.md), and the repository-provided deterministic validator when available. Report errors and warnings separately. |
 | `quality-audit` | Run `validate` first; then load [documentation-quality-audit.md](references/documentation-quality-audit.md). Report findings; do not rewrite project meaning. |
 | `documentation-compression` | Load [documentation-compression.md](references/documentation-compression.md). Rewrite only with authorization and preserve accepted meaning. |
@@ -53,7 +63,7 @@ The existing context supplies accepted project meaning; this installed skill sup
 
 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.
 
-The current target is schema `0.5.0`. npm package updates and context evolution are separate: package patches may retain the same supported schema. 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.
+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.
 
 ## Resource Ownership
 

package/skills/adsm-ctx/references/agents-hierarchy.md

@@ -1,7 +1,7 @@
 # AGENTS Hierarchy
 
 - Path: `skills/adsm-ctx/references/agents-hierarchy.md`
-- Changed: `20260715`
+- Changed: `20261104`
 
 This reference operationalizes `AGENTS.md` handling for ADSM contexts.
 
@@ -32,6 +32,8 @@ Repository-root and context-side files are not identical:
 - the repository-root `AGENTS.md` controls root work and may use a lighter shape;
 - context-side `AGENTS.md` files under `ctx/` must contain `Purpose`, `Level Map`, and `Level Boundary`.
 
+The root template states the skill's Rapid Evolution development default concisely and routes agents to the skill for its meaning. Accepted project context may strengthen or replace that default under human authority; deeper instructions must preserve the root's security, integrity, and accepted-context boundaries. Initialization does not overwrite existing root instructions.
+
 For skill operation:
 
 - interpret `AGENTS.md` as local control files inside already-declared boundaries;

package/skills/adsm-ctx/references/context-evolution.md

@@ -1,16 +1,20 @@
 # Agent-Driven Context Evolution
 
 - Path: `skills/adsm-ctx/references/context-evolution.md`
-- Changed: `20261024`
+- Changed: `20261105`
 
 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.
 
+Apply the skill's Rapid Evolution default to planning and verification: work toward accepted target meaning in small feedback cycles, without preserving obsolete software behavior by default. This does not make existing context or schema disposable: investigate actual conventions, preserve accepted meaning and decisions, and obtain human approval for semantic or authority changes. Do not automatically rewrite consumer projects when the skill or root template changes. Required reliability and verification remain controlled by humans and applicable project context.
+
 ## Target And Responsibilities
 
-The current target is context schema `adsm-context` version `0.5.0`, independent of the npm package version. 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.
+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.
 
 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.
 
+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.
+
 ## 1. Discover
 
 Inspect applicable `AGENTS.md` instructions, the existing context and metadata, filesystem types, Git boundaries, and current worktree changes. Identify separately mounted `ctx/` and keep each history in place. Do not remove, replace, relocate, or unmount it. Do not traverse unrelated repositories or secret-bearing files. Resolve unsafe links, nested repository ownership, or missing permissions before editing affected paths.
@@ -23,7 +27,7 @@ Locate authoritative product intent, architecture decisions and rationale, envir
 
 ## 3. Compare
 
-Compare actual structure and meaning with current target conventions, even when the recorded version is unknown or already `0.5.0`. 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.
+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.
 
 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,23 +37,23 @@ Classify proposed changes as structural, editorial, semantic, or requiring human
 
 ## 5. Evolve
 
-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.5.0`, 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.
+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.
 
 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.
 
 ## 6. Validate
 
-Run deterministic validation and inspect every error and warning. Assess semantic consistency across declarations, decisions, projections, and local instructions separately. Confirm preserved project-specific knowledge and correct Git boundaries. If the context still bears a known older schema label, the validator's version finding is expected: establish that all other target requirements pass before promotion. Never ignore malformed metadata, unknown-version ambiguity, or unresolved semantic conflicts as merely a version mismatch. Obtain required human decisions before finalizing.
+Run deterministic validation and inspect every error and warning. Assess semantic consistency across declarations, decisions, projections, and local instructions separately. Confirm preserved project-specific knowledge and correct Git boundaries. If the context still bears an unsupported schema label, the validator's version finding is expected: establish that all other target requirements pass before promotion. Never ignore malformed metadata, unknown-version ambiguity, or unresolved semantic conflicts as merely a version mismatch. Obtain required human decisions before finalizing.
 
 ## 7. Finalize
 
-Only after target structural requirements and semantic consistency are satisfied, update `ctx/adsm.json` to version `0.5.0`, 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.
+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.
 
 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.
 
 
 ## Package Updates And Schema Compatibility
 
-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.5.1` may support schema `0.5.0` unchanged. Never infer compatibility from numerical equality.
+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.
 
-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. Older or intermediate labels, including `0.3.0`, do not require sequential migrations; investigate actual state and evolve directly toward the understood target. Never relabel an older context based solely on package installation.
+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.

package/skills/adsm-ctx/references/context-lifecycle.md

@@ -1,7 +1,7 @@
 # Context Lifecycle
 
 - Path: `skills/adsm-ctx/references/context-lifecycle.md`
-- Changed: `20261024`
+- Changed: `20261104`
 
 `adsm-ctx` manages six lifecycle modes for project cognitive context.
 
@@ -27,7 +27,7 @@ The lifecycle is iterative. A project may return to `design`, `validate`, `quali
 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:
 
 ```sh
-npm install --global git+ssh://git@github.com/flancer32/skill-adsm-ctx.git
+npm install --global @flancer32/skill-adsm-ctx
 adsm-ctx install-skill "$HOME/.agents/skills"
 ```
 

package/skills/adsm-ctx/references/document-projections.md

@@ -1,7 +1,7 @@
 # Documentation Projections
 
 - Path: `skills/adsm-ctx/references/document-projections.md`
-- Changed: `20261024`
+- Changed: `20261105`
 
 Use this reference whenever an agent initializes, designs, validates, audits, compresses, or evolves ADSM documentation under `ctx/docs/`.
 
@@ -122,7 +122,9 @@ Their meanings remain:
 
 `ctx/docs/verification/` is a mandatory cross-cutting documentation block. It relates declarations to observations of reality, but is not a fifth refinement level and does not change declaration authority.
 
-Require the block in schema `0.5.0`, 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.
+For the distinction between project testing and product verification, evidence limits, and npm command conventions, see [testing-and-verification.md](testing-and-verification.md).
+
+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.
 
 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.
 

package/skills/adsm-ctx/references/testing-and-verification.md

@@ -0,0 +1,20 @@
+# Project Testing And Product Verification
+
+- Path: `skills/adsm-ctx/references/testing-and-verification.md`
+- Changed: `20261105`
+
+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.
+
+Product verification assesses a declared product property or behavior through bounded observations guided by applicable specifications under `ctx/docs/verification/`. Specifications identify the target, applicable state, approach, and interpretation limits; actual evidence and its provenance remain separate. Explain what each scenario establishes and what it does not: a controlled collaborator can support a bounded contract check, but does not prove live interoperability. The Verification Layer is cross-cutting and cannot redefine accepted product meaning.
+
+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.
+
+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.
+
+## Fresh First-Party Integration
+
+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.
+
+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.
+
+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.

package/skills/adsm-ctx/templates/AGENTS.md

@@ -1,7 +1,7 @@
 # Root Level
 
 - Path: `AGENTS.md`
-- Template Version: `20261024`
+- Template Version: `20261105`
 - Changed: `YYYYMMDD`
 
 ## Boundary
@@ -12,8 +12,20 @@ This file controls repository work. `ctx/` owns project meaning and is authorita
 
 A task may cover multiple repositories. Coordinate affected contracts and consumers, verify their integration, and keep each Git history separate. Do not expand into unrelated repositories. The human defines scope and approves changes to accepted meaning.
 
+## Development Policy
+
+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.
+
+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.
+
 ## Efficient Execution
 
 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.
 
 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.
+
+## Git Delivery
+
+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.
+
+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.

package/skills/adsm-ctx/templates/ctx/README.md

@@ -1,7 +1,7 @@
 # Cognitive Context
 
 - Path: `ctx/README.md`
-- Template Version: `20260623`
+- Template Version: `20261024`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/skills/adsm-ctx/templates/ctx/adsm.json

@@ -1,6 +1,6 @@
 {
   "schema": "adsm-context",
-  "version": "0.5.0",
+  "version": "0.7",
   "capabilities": [
     "verification-layer"
   ],

package/skills/adsm-ctx/templates/ctx/docs/architecture/AGENTS.md

@@ -1,7 +1,7 @@
 # Architecture Documentation
 
 - Path: `ctx/docs/architecture/AGENTS.md`
-- Template Version: `20260702`
+- Template Version: `20260708`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/skills/adsm-ctx/templates/ctx/docs/architecture/behavior.md

@@ -1,7 +1,7 @@
 # Architecture Behavior
 
 - Path: `ctx/docs/architecture/behavior.md`
-- Template Version: `20260605`
+- Template Version: `20261105`
 - Changed: `YYYYMMDD`
 
 ## Purpose
@@ -14,7 +14,7 @@ This document explains how the system works internally, not which product outcom
 
 Describe the main architectural flows that matter for the system.
 
-Examples may include request handling, synchronization, ingestion, supervision, background processing, or recovery.
+Examples may include request handling, synchronization, ingestion, supervision, or background processing when relevant.
 
 Do not rewrite product use cases here.
 
@@ -27,9 +27,9 @@ For each major flow, clarify:
 - where important decisions are made;
 - where the flow ends or commits durable change.
 
-## Failure And Recovery
+## Failure Behavior
 
-Describe important failure handling, retry, fallback, or degradation behavior at the architectural level.
+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.
 
 ## Product Dependency
 

package/skills/adsm-ctx/templates/ctx/docs/code/AGENTS.md

@@ -1,7 +1,7 @@
 # Code Documentation
 
 - Path: `ctx/docs/code/AGENTS.md`
-- Template Version: `20260702`
+- Template Version: `20260708`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/skills/adsm-ctx/templates/ctx/docs/code/testing.md

@@ -1,7 +1,7 @@
 # Testing Overview
 
 - Path: `ctx/docs/code/testing.md`
-- Template Version: `20260605`
+- Template Version: `20261104`
 - Changed: `YYYYMMDD`
 
 ## Purpose
@@ -15,3 +15,5 @@ List the main test layers, directories, and intended verification scope.
 ## Verification Target Boundary
 
 Keep executable test organization, framework conventions, fixtures, and isolation in this code-level document. When a project adds a durable specification under the mandatory `ctx/docs/verification/` boundary, that specification states the observed declared expectation and primary target; the executable mechanism remains governed here.
+
+Distinguish project health checks from product verification and document each command's scope and limits. Apply the `adsm-ctx` skill's testing and verification guidance to the project's ecosystem and risk.

package/skills/adsm-ctx/templates/ctx/docs/environment/AGENTS.md

@@ -1,7 +1,7 @@
 # Environment Documentation
 
 - Path: `ctx/docs/environment/AGENTS.md`
-- Template Version: `20260702`
+- Template Version: `20260708`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/skills/adsm-ctx/templates/ctx/docs/filesystem.md

@@ -1,7 +1,7 @@
 # Filesystem Structure
 
 - Path: `ctx/docs/filesystem.md`
-- Template Version: `20260605`
+- Template Version: `20260707`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/skills/adsm-ctx/templates/ctx/docs/product/AGENTS.md

@@ -1,7 +1,7 @@
 # Product Documentation
 
 - Path: `ctx/docs/product/AGENTS.md`
-- Template Version: `20260702`
+- Template Version: `20260708`
 - Changed: `YYYYMMDD`
 
 ## Purpose

package/src/Cli/Command/Init.mjs

@@ -1,13 +1,25 @@
 // @ts-check
 
-import processModule from "node:process";
-
-/** @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Init */
+/**
+ * @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Init
+ * @description Initializes project context via the CLI.
+ */
 export default class Init {
-  constructor({config, init}) {
+  /**
+   * @param {object} deps
+   * @param {Fl32_Skill_Adsm_Ctx_Cli_Config} deps.config
+   * @param {Fl32_Skill_Adsm_Ctx_Init_Service} deps.init
+   * @param {typeof import("node:process")} deps.processModule
+   */
+  constructor({config, init, processModule}) {
     this.id = "adsm-ctx:init";
     this.summary = "Initialize an ADSM context.";
     this.lifetime = "finite";
+    /**
+     * @param {object} deps
+     * @param {Record<string, string>} deps.args
+     * @returns {Promise<void>}
+     */
     this.execute = async function ({args}) {
       const result = await init.execute({targetPath: args["target-path"] ?? config.cwd});
       processModule.stdout.write(`${formatInitReport(result)}\n`);
@@ -15,8 +27,12 @@ export default class Init {
   }
 }
 
+/**
+ * @param {Fl32_Skill_Adsm_Ctx_Init_Result} result
+ * @returns {string}
+ */
 function formatInitReport(result) {
   return [`Initialized ADSM context in ${result.ctxRoot}`, ...result.created.map((entry) => `Created: ${entry}`), ...result.skipped.map((entry) => `Skipped: ${entry}`)].join("\n");
 }
 
-export const __deps__ = Object.freeze({default: Object.freeze({config: "TeqFw_Cli_Config$", init: "Fl32_Skill_Adsm_Ctx_Init_Service$"})});
+export const __deps__ = Object.freeze({default: Object.freeze({processModule: "node:process", config: "TeqFw_Cli_Config$", init: "Fl32_Skill_Adsm_Ctx_Init_Service$"})});

package/src/Cli/Command/InstallSkill.mjs

@@ -1,13 +1,24 @@
 // @ts-check
 
-import processModule from "node:process";
-
-/** @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_InstallSkill */
+/**
+ * @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_InstallSkill
+ * @description Installs the skill payload via the CLI.
+ */
 export default class InstallSkill {
-  constructor({installer}) {
+  /**
+   * @param {object} deps
+   * @param {Fl32_Skill_Adsm_Ctx_Skill_Installer} deps.installer
+   * @param {typeof import("node:process")} deps.processModule
+   */
+  constructor({installer, processModule}) {
     this.id = "adsm-ctx:install-skill";
     this.summary = "Install the bundled agent skill payload.";
     this.lifetime = "finite";
+    /**
+     * @param {object} deps
+     * @param {Record<string, string>} deps.args
+     * @returns {Promise<void>}
+     */
     this.execute = async function ({args}) {
       const targetDir = await installer.execute({targetRoot: args["skills-root"]});
       processModule.stdout.write(`Installed skill payload to ${targetDir}\n`);
@@ -15,4 +26,4 @@ export default class InstallSkill {
   }
 }
 
-export const __deps__ = Object.freeze({default: Object.freeze({installer: "Fl32_Skill_Adsm_Ctx_Skill_Installer$"})});
+export const __deps__ = Object.freeze({default: Object.freeze({processModule: "node:process", installer: "Fl32_Skill_Adsm_Ctx_Skill_Installer$"})});

package/src/Cli/Command/Validate.mjs

@@ -1,13 +1,25 @@
 // @ts-check
 
-import processModule from "node:process";
-
-/** @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Validate */
+/**
+ * @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Validate
+ * @description Validates project context via the CLI.
+ */
 export default class Validate {
-  constructor({config, validate}) {
+  /**
+   * @param {object} deps
+   * @param {Fl32_Skill_Adsm_Ctx_Cli_Config} deps.config
+   * @param {typeof import("node:process")} deps.processModule
+   * @param {Fl32_Skill_Adsm_Ctx_Validate_Service} deps.validate
+   */
+  constructor({config, processModule, validate}) {
     this.id = "adsm-ctx:validate";
     this.summary = "Validate an ADSM context.";
     this.lifetime = "finite";
+    /**
+     * @param {object} deps
+     * @param {Record<string, string>} deps.args
+     * @returns {Promise<void>}
+     */
     this.execute = async function ({args}) {
       const result = await validate.execute({targetPath: args["target-path"] ?? config.cwd});
       processModule.stdout.write(`${validate.format({result})}\n`);
@@ -16,4 +28,4 @@ export default class Validate {
   }
 }
 
-export const __deps__ = Object.freeze({default: Object.freeze({config: "TeqFw_Cli_Config$", validate: "Fl32_Skill_Adsm_Ctx_Validate_Service$"})});
+export const __deps__ = Object.freeze({default: Object.freeze({processModule: "node:process", config: "TeqFw_Cli_Config$", validate: "Fl32_Skill_Adsm_Ctx_Validate_Service$"})});

package/src/Init/Service.mjs

@@ -21,9 +21,9 @@ export default class Service {
     /**
      * Creates baseline context structure in the target project.
      *
-     * @param {object} params
-     * @param {string} params.targetPath
-     * @returns {Promise<{created: string[], ctxRoot: string, projectRoot: string, skipped: string[]}>}
+     * @param {object} deps
+     * @param {string} deps.targetPath
+     * @returns {Promise<Fl32_Skill_Adsm_Ctx_Init_Result>}
      */
     this.execute = async function ({targetPath}) {
       const projectRoot = pathService.resolve(targetPath);
@@ -49,12 +49,12 @@ export default class Service {
 }
 
 /**
- * @param {object} params
- * @param {string[]} params.created
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @param {string[]} params.skipped
+ * @param {object} deps
+ * @param {Array<string>} deps.created
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @param {Array<string>} deps.skipped
  * @returns {void}
  */
 function ensureRootAgents({created, fs, pathService, projectRoot, skipped}) {
@@ -68,11 +68,11 @@ function ensureRootAgents({created, fs, pathService, projectRoot, skipped}) {
 }
 
 /**
- * @param {object} params
- * @param {string[]} params.created
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
+ * @param {object} deps
+ * @param {Array<string>} deps.created
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
  * @returns {void}
  */
 function stampCreatedMarkdownDates({created, fs, pathService, projectRoot}) {
@@ -87,13 +87,13 @@ function stampCreatedMarkdownDates({created, fs, pathService, projectRoot}) {
 }
 
 /**
- * @param {object} params
- * @param {string[]} params.created
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Metadata} params.metadata
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @param {string[]} params.skipped
+ * @param {object} deps
+ * @param {Array<string>} deps.created
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Metadata} deps.metadata
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @param {Array<string>} deps.skipped
  * @returns {void}
  */
 function writeMetadata({created, fs, metadata, pathService, projectRoot, skipped}) {

package/src/Shared/Constants.mjs

@@ -6,9 +6,10 @@
  */
 
 export default class Constants {
+  /** Initializes the supported context constants. */
   constructor() {
     this.CONTEXT_SCHEMA = "adsm-context";
-    this.CONTEXT_VERSION = "0.5.0";
+    this.CONTEXT_VERSION = "0.7";
     this.VERIFICATION_CAPABILITY = "verification-layer";
     this.CONTEXT_CAPABILITIES = Object.freeze([this.VERIFICATION_CAPABILITY]);
     this.VERIFICATION_BLOCK = "verification";

package/src/Shared/CopyDirectory.mjs

@@ -15,9 +15,9 @@ export default class CopyDirectory {
     /**
      * Copies a directory tree recursively.
      *
-     * @param {object} params
-     * @param {string} params.sourcePath
-     * @param {string} params.targetPath
+     * @param {object} deps
+     * @param {string} deps.sourcePath
+     * @param {string} deps.targetPath
      * @returns {void}
      */
     this.execute = function ({sourcePath, targetPath}) {
@@ -36,12 +36,12 @@ export default class CopyDirectory {
     /**
      * Copies only missing directories and files from source to target.
      *
-     * @param {object} params
-     * @param {string[]} params.created
-     * @param {string} params.pathPrefix
-     * @param {string[]} params.skipped
-     * @param {string} params.sourcePath
-     * @param {string} params.targetPath
+     * @param {object} deps
+     * @param {Array<string>} deps.created
+     * @param {string} deps.pathPrefix
+     * @param {Array<string>} deps.skipped
+     * @param {string} deps.sourcePath
+     * @param {string} deps.targetPath
      * @returns {void}
      */
     this.copyMissing = function ({created, pathPrefix, skipped, sourcePath, targetPath}) {

package/src/Shared/Metadata.mjs

@@ -14,7 +14,7 @@ export default class Metadata {
     /**
      * Creates the baseline metadata object.
      *
-     * @returns {{schema: string, version: string}}
+     * @returns {Fl32_Skill_Adsm_Ctx_Metadata_Value}
      */
     this.create = function () {
       return {

package/src/Skill/Installer.mjs

@@ -19,8 +19,8 @@ export default class Installer {
     /**
      * Installs the skill payload.
      *
-     * @param {object} params
-     * @param {string} params.targetRoot
+     * @param {object} deps
+     * @param {string} deps.targetRoot
      * @returns {Promise<string>}
      */
     this.execute = async function ({targetRoot}) {

package/src/Validate/Service.mjs

@@ -21,30 +21,9 @@ export default class Validate {
     /**
      * Validates context structure.
      *
-     * @param {object} params
-     * @param {string} params.targetPath
-     * @returns {Promise<{
-     *   errorCount: number,
-     *   findings: {
-     *     message: string,
-     *     path: string,
-     *     ruleId: string,
-     *     severity: "error" | "warning"
-     *   }[],
-     *   metadata: {capabilities?: string[], schema: string, version: string, initializedAt?: string} | null,
-     *   missingPaths: string[],
-     *   ok: boolean,
-     *   projectRoot: string,
-     *   projection: {
-     *     assets: string[],
-     *     bodies: string[],
-     *     orphanSkins: string[],
-     *     pairs: {body: string, skin: string}[],
-     *     skins: string[],
-     *     verification: {categories: string[], present: boolean}
-     *   },
-     *   warningCount: number
-     * }>}
+     * @param {object} deps
+     * @param {string} deps.targetPath
+     * @returns {Promise<Fl32_Skill_Adsm_Ctx_Validate_Result>}
      */
     this.execute = async function ({targetPath}) {
       const projectRoot = pathService.resolve(targetPath);
@@ -96,20 +75,8 @@ export default class Validate {
     /**
      * Formats validation result for CLI output.
      *
-     * @param {object} params
-     * @param {{
-     *   errorCount: number,
-     *   findings: {
-     *     message: string,
-     *     path: string,
-     *     ruleId: string,
-     *     severity: "error" | "warning"
-     *   }[],
-     *   metadata: {version: string} | null,
-     *   ok: boolean,
-     *   projectRoot: string,
-     *   warningCount: number
-     * }} params.result
+     * @param {object} deps
+     * @param {Fl32_Skill_Adsm_Ctx_Validate_Result} deps.result
      * @returns {string}
      */
     this.format = function ({result}) {
@@ -140,12 +107,12 @@ export default class Validate {
 }
 
 /**
- * @param {object} params
- * @param {string} params.message
- * @param {string} params.path
- * @param {string} params.ruleId
- * @param {"error" | "warning"} params.severity
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}}
+ * @param {object} deps
+ * @param {string} deps.message
+ * @param {string} deps.path
+ * @param {string} deps.ruleId
+ * @param {Fl32_Skill_Adsm_Ctx_Finding_Severity} deps.severity
+ * @returns {Fl32_Skill_Adsm_Ctx_Finding}
  */
 function createFinding({message, path, ruleId, severity}) {
   return {message, path, ruleId, severity};
@@ -155,7 +122,7 @@ function createFinding({message, path, ruleId, severity}) {
  * Classifies a semantic-skin filename and derives its canonical agent document.
  *
  * @param {string} file
- * @returns {{body: string, language: string | null, markerError: string | null} | null}
+ * @returns {Fl32_Skill_Adsm_Ctx_SkinInfo_Optional}
  */
 function parseSkinFilename(file) {
   const explicitMatch = file.match(EXPLICIT_SKIN_FILENAME);
@@ -185,18 +152,12 @@ function parseSkinFilename(file) {
 }
 
 /**
- * @param {object} params
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @returns {{
- *   ok: false,
- *   finding: {message: string, path: string, ruleId: string, severity: "error" | "warning"}
- * } | {
- *   ok: true,
- *   metadata: {schema: string, version: string, initializedAt?: string}
- * }}
+ * @param {object} deps
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} deps.constants
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @returns {Fl32_Skill_Adsm_Ctx_Metadata_ReadResult}
  */
 function readMetadata({constants, fs, pathService, projectRoot}) {
   const findings = [];
@@ -223,9 +184,7 @@ function readMetadata({constants, fs, pathService, projectRoot}) {
     }
     if (parsed.version !== constants.CONTEXT_VERSION) {
       findings.push(createFinding({
-        message: ["0.1.0", "0.2.0", "0.3.0"].includes(parsed.version)
-          ? `Legacy schema ${parsed.version}; use skill adsm-ctx for agent-driven context evolution. Target schema: ${constants.CONTEXT_VERSION}.`
-          : `Unsupported metadata version: ${parsed.version}; investigate with skill adsm-ctx before changing schema metadata.`,
+        message: `Unsupported metadata version: ${parsed.version}; target schema: ${constants.CONTEXT_VERSION}. Investigate with skill adsm-ctx before changing schema metadata.`,
         path: "ctx/adsm.json",
         ruleId: "metadata-version",
         severity: "error",
@@ -279,26 +238,13 @@ function readMetadata({constants, fs, pathService, projectRoot}) {
 }
 
 /**
- * @param {object} params
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @returns {{
- *   findings: {
- *     message: string,
- *     path: string,
- *     ruleId: string,
- *     severity: "error" | "warning"
- *   }[],
- *   summary: {
- *     assets: string[],
- *     bodies: string[],
- *     orphanSkins: string[],
- *     pairs: {body: string, skin: string}[],
- *     skins: string[]
- *   }
- * }}
+ * @param {object} deps
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} deps.constants
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @param {Fl32_Skill_Adsm_Ctx_Metadata_Optional} deps.metadata
+ * @returns {Fl32_Skill_Adsm_Ctx_Projection_Result}
  */
 function inspectProjection({constants, fs, metadata, pathService, projectRoot}) {
   const docsRoot = pathService.join(projectRoot, "ctx", "docs");
@@ -441,16 +387,13 @@ function inspectProjection({constants, fs, metadata, pathService, projectRoot})
  * Inspects the cross-cutting Verification Layer without treating it as a fifth
  * declarative documentation level.
  *
- * @param {object} params
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {Map<string, {name: string, isDirectory: () => boolean, isFile: () => boolean}>} params.docsEntryMap
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @returns {{
- *   findings: {message: string, path: string, ruleId: string, severity: "error" | "warning"}[],
- *   summary: {categories: string[], present: boolean}
- * }}
+ * @param {object} deps
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} deps.constants
+ * @param {Fl32_Skill_Adsm_Ctx_DirectoryEntryMap} deps.docsEntryMap
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @returns {Fl32_Skill_Adsm_Ctx_Verification_Result}
  */
 function inspectVerificationBlock({constants, docsEntryMap, fs, pathService, projectRoot}) {
   const findings = [];
@@ -550,13 +493,13 @@ function inspectVerificationBlock({constants, docsEntryMap, fs, pathService, pro
  * Warns when a documentation level exceeds the recommended direct-entry capacity
  * and requires its local AGENTS.md to make an intentional exception explicit.
  *
- * @param {object} params
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {Map<string, {name: string, isDirectory: () => boolean, isFile: () => boolean}>} params.docsEntryMap
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}[]}
+ * @param {object} deps
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} deps.constants
+ * @param {Fl32_Skill_Adsm_Ctx_DirectoryEntryMap} deps.docsEntryMap
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_Finding>}
  */
 function validateDocumentationLevelCapacity({constants, docsEntryMap, fs, pathService, projectRoot}) {
   const findings = [];
@@ -622,12 +565,12 @@ function validateDocumentationLevelCapacity({constants, docsEntryMap, fs, pathSe
 }
 
 /**
- * @param {object} params
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.root
- * @param {string} params.prefix
- * @returns {string[]}
+ * @param {object} deps
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.root
+ * @param {string} deps.prefix
+ * @returns {Array<string>}
  */
 function listFiles({fs, pathService, root, prefix}) {
   const result = [];
@@ -644,21 +587,20 @@ function listFiles({fs, pathService, root, prefix}) {
 }
 
 /**
- * @param {object} params
- * @param {typeof import("node:fs")} params.fs
- * @param {string} params.root
- * @returns {{name: string, isDirectory: () => boolean, isFile: () => boolean}[]}
+ * @param {object} deps
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {string} deps.root
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_DirectoryEntry>}
  */
 function listEntries({fs, root}) {
   return fs.readdirSync(root, {withFileTypes: true});
 }
 
 /**
- * @param {object} params
- * @param {string} params.file
- * @param {{body: string, language: string | null, markerError: string | null}} params.skinInfo
- * @param {string} params.text
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}[]}
+ * @param {object} deps
+ * @param {string} deps.file
+ * @param {string} deps.text
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_Finding>}
  */
 function validateDocumentMetadata({file, text}) {
   const findings = [];
@@ -700,13 +642,13 @@ function validateDocumentMetadata({file, text}) {
 }
 
 /**
- * @param {object} params
- * @param {string} params.file
- * @param {typeof import("node:fs")} params.fs
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} params.pathService
- * @param {string} params.projectRoot
- * @param {string} params.text
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}[]}
+ * @param {object} deps
+ * @param {string} deps.file
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @param {string} deps.text
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_Finding>}
  */
 function validateLocalMarkdownLinks({file, fs, pathService, projectRoot, text}) {
   const findings = [];
@@ -738,12 +680,13 @@ function validateLocalMarkdownLinks({file, fs, pathService, projectRoot, text})
 }
 
 /**
- * @param {object} params
- * @param {Set<string>} params.bodySet
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {string} params.file
- * @param {string} params.text
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}[]}
+ * @param {object} deps
+ * @param {Fl32_Skill_Adsm_Ctx_StringSet} deps.bodySet
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} deps.constants
+ * @param {string} deps.file
+ * @param {Fl32_Skill_Adsm_Ctx_SkinInfo} deps.skinInfo
+ * @param {string} deps.text
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_Finding>}
  */
 function validateSkinDocument({bodySet, constants, file, skinInfo, text}) {
   const findings = [];
@@ -767,9 +710,9 @@ function validateSkinDocument({bodySet, constants, file, skinInfo, text}) {
 }
 
 /**
- * @param {object} params
- * @param {string} params.sectionName
- * @param {string} params.text
+ * @param {object} deps
+ * @param {string} deps.sectionName
+ * @param {string} deps.text
  * @returns {string}
  */
 function extractSectionBody({sectionName, text}) {
@@ -789,10 +732,10 @@ function extractSectionBody({sectionName, text}) {
 }
 
 /**
- * @param {object} params
- * @param {string} params.file
- * @param {string} params.link
- * @returns {{fragment: string | null, path: string} | null}
+ * @param {object} deps
+ * @param {string} deps.file
+ * @param {string} deps.link
+ * @returns {Fl32_Skill_Adsm_Ctx_Validate_Link_Optional}
  */
 function normalizeLocalMarkdownLink({file, link}) {
   const trimmed = link.trim();
@@ -819,8 +762,8 @@ function normalizeLocalMarkdownLink({file, link}) {
 }
 
 /**
- * @param {string[]} parts
- * @returns {string[]}
+ * @param {Array<string>} parts
+ * @returns {Array<string>}
  */
 function normalizeRelativeSegments(parts) {
   const result = [];
@@ -835,17 +778,23 @@ function normalizeRelativeSegments(parts) {
   return result;
 }
 
-export const __deps__ = Object.freeze({default: Object.freeze({
-  constants: "Fl32_Skill_Adsm_Ctx_Shared_Constants$",
-  fs: "node:fs",
-  pathService: "Fl32_Skill_Adsm_Ctx_Shared_Path$",
-})});
-
-/** Checks context-side routing sections; root repository instructions have a separate shape. */
+/**
+ * Checks context-side routing sections; root repository instructions have a separate shape.
+ * @param {object} deps
+ * @param {typeof import("node:fs")} deps.fs
+ * @param {Fl32_Skill_Adsm_Ctx_Shared_Path} deps.pathService
+ * @param {string} deps.projectRoot
+ * @returns {Array<Fl32_Skill_Adsm_Ctx_Finding>}
+ */
 function inspectAgentsHierarchy({fs, pathService, projectRoot}) {
   const findings = [];
   const root = pathService.join(projectRoot, "ctx");
   if (!fs.existsSync(root)) return findings;
+  /**
+   * @param {string} directory
+   * @param {string} relative
+   * @returns {void}
+   */
   const visit = (directory, relative) => {
     let entries;
     try { entries = listEntries({fs, root: directory}); }
@@ -890,3 +839,9 @@ function inspectAgentsHierarchy({fs, pathService, projectRoot}) {
   visit(root, "ctx");
   return findings;
 }
+
+export const __deps__ = Object.freeze({default: Object.freeze({
+  constants: "Fl32_Skill_Adsm_Ctx_Shared_Constants$",
+  fs: "node:fs",
+  pathService: "Fl32_Skill_Adsm_Ctx_Shared_Path$",
+})});

package/types.d.ts

@@ -1,14 +1,45 @@
 declare global {
   type Fl32_Skill_Adsm_Ctx_Cli_Command_Init = import("./src/Cli/Command/Init.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Init__Class = typeof import("./src/Cli/Command/Init.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Cli_Command_InstallSkill = import("./src/Cli/Command/InstallSkill.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_InstallSkill__Class = typeof import("./src/Cli/Command/InstallSkill.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Cli_Command_Validate = import("./src/Cli/Command/Validate.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Validate__Class = typeof import("./src/Cli/Command/Validate.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Config = {cwd: string};
+  type Fl32_Skill_Adsm_Ctx_DirectoryEntry = {name: string; isDirectory: () => boolean; isFile: () => boolean};
+  type Fl32_Skill_Adsm_Ctx_DirectoryEntryMap = {get: (name: string) => Fl32_Skill_Adsm_Ctx_DirectoryEntry | undefined};
+  type Fl32_Skill_Adsm_Ctx_Finding = {message: string; path: string; ruleId: string; severity: "error" | "warning"};
+  type Fl32_Skill_Adsm_Ctx_Finding_Severity = "error" | "warning";
+  type Fl32_Skill_Adsm_Ctx_Init_Result = {created: Array<string>; ctxRoot: string; projectRoot: string; skipped: Array<string>};
   type Fl32_Skill_Adsm_Ctx_Init_Service = import("./src/Init/Service.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Init_Service__Class = typeof import("./src/Init/Service.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Metadata = {schema: string; version: string; capabilities?: Array<string>; initializedAt?: string};
+  type Fl32_Skill_Adsm_Ctx_Metadata_Optional = Fl32_Skill_Adsm_Ctx_Metadata | null;
+  type Fl32_Skill_Adsm_Ctx_Metadata_ReadResult = {findings: Array<Fl32_Skill_Adsm_Ctx_Finding>; metadata: Fl32_Skill_Adsm_Ctx_Metadata | null; ok: boolean};
+  type Fl32_Skill_Adsm_Ctx_Metadata_Value = {schema: string; version: string; capabilities: Array<string>};
+  type Fl32_Skill_Adsm_Ctx_Projection = {assets: Array<string>; bodies: Array<string>; orphanSkins: Array<string>; pairs: Array<Fl32_Skill_Adsm_Ctx_Projection_Pair>; skins: Array<string>; verification?: Fl32_Skill_Adsm_Ctx_Verification_Summary};
+  type Fl32_Skill_Adsm_Ctx_Projection_Pair = {body: string; skin: string};
+  type Fl32_Skill_Adsm_Ctx_Projection_Result = {findings: Array<Fl32_Skill_Adsm_Ctx_Finding>; summary: Fl32_Skill_Adsm_Ctx_Projection};
   type Fl32_Skill_Adsm_Ctx_Shared_Constants = import("./src/Shared/Constants.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Shared_Constants__Class = typeof import("./src/Shared/Constants.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Shared_CopyDirectory = import("./src/Shared/CopyDirectory.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Shared_CopyDirectory__Class = typeof import("./src/Shared/CopyDirectory.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Shared_Metadata = import("./src/Shared/Metadata.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Shared_Metadata__Class = typeof import("./src/Shared/Metadata.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Shared_Path = import("./src/Shared/Path.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Shared_Path__Class = typeof import("./src/Shared/Path.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Skill_Installer = import("./src/Skill/Installer.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Skill_Installer__Class = typeof import("./src/Skill/Installer.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_SkinInfo = {body: string; language: string | null; markerError: string | null};
+  type Fl32_Skill_Adsm_Ctx_SkinInfo_Optional = Fl32_Skill_Adsm_Ctx_SkinInfo | null;
+  type Fl32_Skill_Adsm_Ctx_StringSet = {has: (value: string) => boolean};
+  type Fl32_Skill_Adsm_Ctx_Validate_Link = {fragment: string | null; path: string};
+  type Fl32_Skill_Adsm_Ctx_Validate_Link_Optional = Fl32_Skill_Adsm_Ctx_Validate_Link | null;
+  type Fl32_Skill_Adsm_Ctx_Validate_Result = {errorCount: number; findings: Array<Fl32_Skill_Adsm_Ctx_Finding>; metadata: Fl32_Skill_Adsm_Ctx_Metadata | null; missingPaths: Array<string>; ok: boolean; projectRoot: string; projection: Fl32_Skill_Adsm_Ctx_Projection; warningCount: number};
   type Fl32_Skill_Adsm_Ctx_Validate_Service = import("./src/Validate/Service.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Validate_Service__Class = typeof import("./src/Validate/Service.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Verification_Result = {findings: Array<Fl32_Skill_Adsm_Ctx_Finding>; summary: Fl32_Skill_Adsm_Ctx_Verification_Summary};
+  type Fl32_Skill_Adsm_Ctx_Verification_Summary = {categories: Array<string>; present: boolean};
 }
 
 export {};