@xn-intenton-z2a/agentic-lib 7.1.11 → 7.1.13

package/README.md

@@ -57,20 +57,15 @@ your-repo/
 ├── agentic-lib.toml                          # [INIT] Config (created once, never overwritten)
 │
 ├── .github/
-│   ├── workflows/                            # [INIT] 13 workflow files (always overwritten)
+│   ├── workflows/                            # [INIT] 8 workflow files (always overwritten)
 │   │   ├── agent-flow-transform.yml          #   Core: transform code toward the mission
 │   │   ├── agent-flow-maintain.yml           #   Core: maintain features and library
 │   │   ├── agent-flow-review.yml             #   Core: review and close resolved issues
 │   │   ├── agent-flow-fix-code.yml           #   Core: fix failing tests
 │   │   ├── agent-discussions-bot.yml         #   Bot: respond to GitHub Discussions
 │   │   ├── agent-supervisor.yml              #   Supervisor: orchestrate the pipeline
-│   │   ├── agent-archive-intentïon.yml       #   Archive the activity log
-│   │   ├── ci-test.yml                       #   CI: run tests
 │   │   ├── ci-automerge.yml                  #   CI: auto-merge passing PRs
-│   │   ├── ci-formating.yml                  #   CI: formatting checks
-│   │   ├── ci-update.yml                     #   CI: dependency updates
-│   │   ├── ci-init.yml                       #   CI: pull latest infrastructure
-│   │   └── publish-packages.yml              #   Release: npm publish
+│   │   └── test.yml                          #   CI: run tests
 │   │
 │   └── agentic-lib/                          # [INIT] Internal infrastructure (always overwritten)
 │       ├── actions/
@@ -95,6 +90,8 @@ your-repo/
 - **[USER]** -- Your files. `init` never touches these. `init --purge` resets them to seed state.
 - **[GENERATED]** -- Created by the agentic workflows during operation.
 
+Your repository should also have an `init.yml` workflow (not distributed — maintained locally) that runs `npx agentic-lib init --purge` on a schedule to keep infrastructure up to date. See [repository0/init.yml](https://github.com/xn-intenton-z2a/repository0/blob/main/.github/workflows/init.yml) for an example.
+
 ### What You Need Before Running `init`
 
 | File | Required? | Notes |
@@ -279,16 +276,16 @@ This repository is the source for the `@xn-intenton-z2a/agentic-lib` npm package
 
 ```
 src/
-├── workflows/     13 GitHub Actions workflow templates
+├── workflows/     7 GitHub Actions workflow templates
 ├── actions/       3 composite/SDK actions (agentic-step, commit-if-changed, setup-npmrc)
 ├── agents/        7 agent prompt files + 1 config
-├── seeds/         Seed files for --purge reset
-└── scripts/       Utility scripts distributed to consumers
+├── seeds/         7 seed files (test.yml + 6 project seed files for --purge reset)
+└── scripts/       7 utility scripts distributed to consumers
 ```
 
 ### Testing
 
-313 unit tests across 21 test files, plus system tests:
+236 unit tests across 21 test files, plus system tests:
 
 ```bash
 npm test                  # Run all tests (vitest)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.11",
+  "version": "7.1.13",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {

package/src/actions/agentic-step/safety.js

@@ -37,7 +37,7 @@ export async function checkWipLimit(octokit, repo, label, limit) {
  * @param {import('@actions/github').GitHub} octokit - GitHub API client
  * @param {Object} repo - { owner, repo } identifying the repository
  * @param {string|number} issueNumber - The issue number
- * @param {string} branchPrefix - Branch naming prefix (e.g. 'agentic-lib-issue-')
+ * @param {string} branchPrefix - Branch naming prefix (e.g. 'agentic-lib-')
  * @returns {Promise<number>} Number of branches matching the pattern
  */
 export async function countBranchAttempts(octokit, repo, issueNumber, branchPrefix) {

package/src/actions/agentic-step/tasks/discussions.js

@@ -27,6 +27,7 @@ export async function discussions(context) {
   let discussionTitle = "";
   let discussionBody = "";
   let discussionComments = [];
+  let discussionNodeId = "";
 
   if (urlMatch) {
     const [, urlOwner, urlRepo, discussionNumber] = urlMatch;
@@ -34,6 +35,7 @@ export async function discussions(context) {
       const query = `query {
         repository(owner: "${urlOwner}", name: "${urlRepo}") {
           discussion(number: ${discussionNumber}) {
+            id
             title
             body
             comments(last: 10) {
@@ -48,6 +50,7 @@ export async function discussions(context) {
       }`;
       const result = await octokit.graphql(query);
       const discussion = result.repository.discussion;
+      discussionNodeId = discussion.id || "";
       discussionTitle = discussion.title || "";
       discussionBody = discussion.body || "";
       discussionComments = discussion.comments.nodes || [];
@@ -128,6 +131,28 @@ export async function discussions(context) {
 
   core.info(`Discussion bot action: ${action}, arg: ${actionArg}`);
 
+  // Post reply comment back to the Discussion
+  if (discussionNodeId && replyBody) {
+    try {
+      const mutation = `mutation($discussionId: ID!, $body: String!) {
+        addDiscussionComment(input: { discussionId: $discussionId, body: $body }) {
+          comment { url }
+        }
+      }`;
+      const { addDiscussionComment } = await octokit.graphql(mutation, {
+        discussionId: discussionNodeId,
+        body: replyBody,
+      });
+      core.info(`Posted reply to discussion: ${addDiscussionComment.comment.url}`);
+    } catch (err) {
+      core.warning(`Failed to post discussion reply: ${err.message}`);
+    }
+  } else if (!discussionNodeId) {
+    core.warning("Cannot post reply: discussion node ID not available");
+  } else if (!replyBody) {
+    core.warning("Cannot post reply: no reply content generated");
+  }
+
   const argSuffix = actionArg ? ` (${actionArg})` : "";
   return {
     outcome: `discussion-${action}`,

package/src/workflows/agent-discussions-bot.yml

@@ -25,7 +25,7 @@ on:
   workflow_dispatch:
 
 permissions:
-  contents: write
+  contents: read
   issues: write
   discussions: write
 
@@ -70,9 +70,3 @@ jobs:
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-discussion-bot.md"
           discussion-url: ${{ steps.discussion-url.outputs.url }}
-
-      - name: Commit activity log changes
-        uses: ./.github/agentic-lib/actions/commit-if-changed
-        with:
-          commit-message: "agentic-step: discussions bot response"
-          push-ref: ${{ github.ref_name }}

package/src/workflows/agent-flow-fix-code.yml

@@ -36,7 +36,7 @@ jobs:
       github.event_name == 'workflow_dispatch' ||
       (github.event_name == 'check_suite' &&
        github.event.check_suite.conclusion == 'failure' &&
-       (startsWith(github.event.check_suite.head_branch, 'agentic-lib-issue-') ||
+       (startsWith(github.event.check_suite.head_branch, 'agentic-lib-') ||
         startsWith(github.event.check_suite.head_branch, 'copilot/')))
     runs-on: ubuntu-latest
     outputs:

package/src/workflows/ci-automerge.yml

@@ -25,7 +25,7 @@ on:
 
 env:
   pullRequestLabel: "automerge"
-  branchPrefix: "agentic-lib-issue-"
+  branchPrefix: "agentic-lib-"
   copilotBranchPrefix: "copilot/"
 
 jobs:
@@ -240,7 +240,7 @@ jobs:
               branchName = pullRequest.head.ref;
               core.info(`branchName '${branchName}'`);
 
-              // Extract issue number from branch name (supports agentic-lib-issue-* and copilot/* prefixes)
+              // Extract issue number from branch name (supports agentic-lib-* and copilot/* prefixes)
               let issueNumberMatch = '';
               if (branchName.startsWith(branchPrefix)) {
                 issueNumberMatch = branchName.replace(branchPrefix, '');
@@ -445,100 +445,3 @@ jobs:
                 owner, repo, issue_number: issueNumber, name: 'in-progress',
               });
             }
-
-  log-intention-activity-merge-pr:
-    needs:
-      - merge-check
-      - automerge
-    if: ${{ !cancelled() && needs.merge-check.outputs.shouldSkipMerge != 'true' && needs.merge-check.outputs.pullNumber != '' }}
-    runs-on: ubuntu-latest
-    env:
-      gitUserEmail: "action@github.com"
-      gitUserName: "GitHub Actions[bot]"
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: main
-
-      - name: Load config
-        id: config
-        run: |
-          CONFIG="${{ vars.configPath || '.github/agentic-lib/agents/agentic-lib.yml' }}"
-          echo "intentionFilepath=$(yq -r '.intentionBot.intentionFilepath // "intentïon.md"' "$CONFIG")" >> $GITHUB_OUTPUT
-
-      - name: Get latest from remote
-        run: |
-          git config --local user.email '${{ env.gitUserEmail }}'
-          git config --local user.name '${{ env.gitUserName }}'
-          git config --local pull.ff     false       # never fast-forward
-          git config --local pull.rebase false       # never rebase on pull
-          git fetch origin main
-          git merge origin/main --no-ff --no-edit --strategy=recursive --strategy-option=ours
-
-      - name: log-intention-activity
-        id: log-intention-activity
-        uses: actions/github-script@v7
-        env:
-          pullNumber: ${{ needs.merge-check.outputs.pullNumber }}
-          shouldSkipMerge: ${{ needs.merge-check.outputs.shouldSkipMerge }}
-          branchName: ${{ needs.merge-check.outputs.branchName }}
-          issueNumber: ${{ needs.merge-check.outputs.issueNumber }}
-          prMerged: ${{ needs.automerge.outputs.prMerged }}
-          message: ${{ needs.automerge.outputs.message }}
-          outcome: ${{ needs.automerge.result }}
-          intentionFilepath: ${{ steps.config.outputs.intentionFilepath }}
-        with:
-          script: |
-            const pullNumber = process.env.pullNumber;
-            const shouldSkipMerge = process.env.shouldSkipMerge;
-            const branchName = process.env.branchName;
-            const issueNumber = process.env.issueNumber;
-            const prMerged = process.env.prMerged;
-            const message = process.env.message;
-            const outcome = process.env.outcome;
-            const intentionFilepath = process.env.intentionFilepath;
-
-            const activity = `When attempting to merge PR #${pullNumber} for branch name "${branchName}" to resolve issue number "${issueNumber}" the decision to skip merge was "${shouldSkipMerge}":
-
-            then the PR was merged "${prMerged}"
-
-            with message: "${message}"
-
-            with outcome "${outcome}".`;
-
-            core.info(`Activity: ${activity}`);
-            core.info(`Seed discussion filepath: ${intentionFilepath}`);
-
-            const fs = require('fs');
-            const path = require('path');
-
-            // Create trace file and the parent directory of intentionFilepath if it doesn't exist
-            if (!fs.existsSync(path.dirname(intentionFilepath))) {
-              fs.mkdirSync(path.dirname(intentionFilepath), { recursive: true });
-            }
-            const isoDate = new Date().toISOString();
-            const activityLogContent = `\n## Merge PR activity at ${isoDate}
-
-            ${activity}
-
-            ---
-            `;
-            if (fs.existsSync(intentionFilepath)) {
-              fs.appendFileSync(intentionFilepath, activityLogContent);
-            } else {
-              fs.writeFileSync(intentionFilepath, activityLogContent);
-            }
-            core.info(`Activity logged to ${intentionFilepath}`);
-
-      - name: Commit changes
-        run: |
-          git config --local user.email '${{ env.gitUserEmail }}'
-          git config --local user.name '${{ env.gitUserName }}'
-          git config --local pull.ff     false       # never fast-forward
-          git config --local pull.rebase false       # never rebase on pull
-          git add  ${{ steps.config.outputs.intentionFilepath }}
-          git commit -m "Activity logged by ci-automerge.yml" || echo "No changes to commit"
-          git fetch origin main
-          git merge origin/main --no-ff --no-edit --strategy=recursive --strategy-option=ours
-          git push -v origin main