@flancer32/skill-adsm-ctx 0.4.0 → 0.6.0

package/src/Init/Service.mjs

@@ -5,29 +5,8 @@
  * @description Initializes the baseline ADSM context structure in a target project directory.
  */
 
-const templateRoot = new URL("../../skill/templates/ctx/", import.meta.url);
-const rootAgentsTemplate = [
-  "# Root Level",
-  "",
-  "- Path: `AGENTS.md`",
-  "- Changed: `20260702`",
-  "",
-  "## Purpose",
-  "",
-  "Marks the repository root and points agents to the project cognitive context in `ctx/`.",
-  "",
-  "## Bootstrap Exception",
-  "",
-  "- `init` and other bootstrap operations may create the initial `ctx/` structure when it does not exist yet.",
-  "- This repository uses an ADSM-managed cognitive context.",
-  "- Use skill `adsm-ctx` for context validation, upgrades, and methodology rules.",
-  "",
-  "## Cognitive Context Entry",
-  "",
-  "- Read `ctx/AGENTS.md` before modifying project files after the context exists.",
-  "- Treat `ctx/` as the source of truth for project context after bootstrap is complete.",
-  "",
-].join("\n");
+const templateRoot = new URL("../../skills/adsm-ctx/templates/ctx/", import.meta.url);
+const rootAgentsTemplate = new URL("../../skills/adsm-ctx/templates/AGENTS.md", import.meta.url);
 
 export default class Service {
   /**
@@ -42,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);
@@ -70,18 +49,18 @@ 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}) {
   const filePath = pathService.join(projectRoot, "AGENTS.md");
   if (!fs.existsSync(filePath)) {
-    fs.writeFileSync(filePath, rootAgentsTemplate);
+    fs.writeFileSync(filePath, fs.readFileSync(rootAgentsTemplate, "utf8").replaceAll("YYYYMMDD", new Date().toISOString().slice(0, 10).replaceAll("-", "")));
     created.push("AGENTS.md");
   } else {
     skipped.push("AGENTS.md");
@@ -89,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}) {
@@ -108,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}) {
@@ -127,10 +106,10 @@ function writeMetadata({created, fs, metadata, pathService, projectRoot, skipped
   }
 }
 
-export const __deps__ = Object.freeze({
+export const __deps__ = Object.freeze({default: Object.freeze({
   copyDirectory: "Fl32_Skill_Adsm_Ctx_Shared_CopyDirectory$",
   fs: "node:fs",
   metadata: "Fl32_Skill_Adsm_Ctx_Shared_Metadata$",
   pathService: "Fl32_Skill_Adsm_Ctx_Shared_Path$",
   url: "node:url",
-});
+})});

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.2.0";
+    this.CONTEXT_VERSION = "0.6";
     this.VERIFICATION_CAPABILITY = "verification-layer";
     this.CONTEXT_CAPABILITIES = Object.freeze([this.VERIFICATION_CAPABILITY]);
     this.VERIFICATION_BLOCK = "verification";
@@ -23,6 +24,8 @@ export default class Constants {
       "ctx/docs/architecture",
       "ctx/docs/environment",
       "ctx/docs/code",
+      "ctx/docs/verification",
+      "ctx/docs/verification/AGENTS.md",
       "ctx/adsm.json",
       "ctx/AGENTS.md",
       "ctx/docs/AGENTS.md",

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

@@ -5,7 +5,7 @@
  * @description Installs the bundled skill payload into a target skills directory.
  */
 
-const sourceRoot = new URL("../../skill/", import.meta.url);
+const sourceRoot = new URL("../../skills/adsm-ctx/", import.meta.url);
 
 export default class Installer {
   /**
@@ -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}) {
@@ -39,9 +39,9 @@ export default class Installer {
   }
 }
 
-export const __deps__ = Object.freeze({
+export const __deps__ = Object.freeze({default: Object.freeze({
   copyDirectory: "Fl32_Skill_Adsm_Ctx_Shared_CopyDirectory$",
   fs: "node:fs",
   pathService: "Fl32_Skill_Adsm_Ctx_Shared_Path$",
   url: "node:url",
-});
+})});