@xn-intenton-z2a/agentic-lib 7.1.6

package/src/seeds/zero-agentic-lib.toml

@@ -0,0 +1,32 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# agentic-lib.toml — Configuration for @xn-intenton-z2a/agentic-lib
+#
+# This file controls how agentic workflows operate on your repository.
+# Place it at the root of your project.
+
+[schedule]
+tier = "schedule-1"       # schedule-1 through schedule-4
+
+[paths]
+mission = "MISSION.md"
+source = "src/lib/"
+tests = "tests/unit/"
+features = ".github/agentic-lib/features/"
+docs = "docs/"
+readme = "README.md"
+dependencies = "package.json"
+
+[execution]
+build = "npm run build"
+test = "npm test"
+start = "npm run start"
+
+[limits]
+feature-issues = 2
+maintenance-issues = 1
+attempts-per-branch = 3
+attempts-per-issue = 2
+
+[bot]
+log-file = "intentïon.md"

package/src/seeds/zero-main.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+// Copyright (C) 2025-2026 Polycode Limited
+// src/lib/main.js
+
+import { fileURLToPath } from "url";
+
+export function main(args) {
+  console.log(`Run with: ${JSON.stringify(args)}`);
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const args = process.argv.slice(2);
+  main(args);
+}

package/src/seeds/zero-main.test.js

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: MIT
+// Copyright (C) 2025-2026 Polycode Limited
+import { describe, test } from "vitest";
+import { main } from "../../src/lib/main.js";
+
+describe("Main Output", () => {
+  test("should terminate without error", () => {
+    process.argv = ["node", "src/lib/main.js"];
+    main();
+  });
+});

package/src/seeds/zero-package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@xn-intenton-z2a/repo",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "main": "src/lib/main.js",
+  "scripts": {
+    "build": "echo \"Nothing to build\"",
+    "test": "vitest --run tests/unit/*.test.js",
+    "test:unit": "vitest --run --coverage tests/unit/*.test.js",
+    "start": "node src/lib/main.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@xn-intenton-z2a/agentic-lib": "^7.1.2"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.0",
+    "vitest": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}

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

@@ -0,0 +1,78 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-discussions-bot.yml
+#
+# Responds to GitHub Discussions using the Copilot SDK.
+# Creates features, seeds repositories, provides status updates.
+
+name: agent-discussions-bot
+run-name: "agent-discussions-bot [${{ github.ref_name }}]"
+concurrency: agentic-lib-bot
+
+on:
+  discussion:
+    types:
+      - created
+      - edited
+      - answered
+      - unanswered
+  discussion_comment:
+    types:
+      - created
+      - edited
+  schedule:
+    - cron: "7 12 */28 * *" # schedule-1: every 28 days
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  issues: write
+  discussions: write
+
+env:
+  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+
+jobs:
+  respond:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Get discussion URL
+        id: discussion-url
+        uses: actions/github-script@v7
+        with:
+          script: |
+            let url = '';
+            if (context.payload.discussion) {
+              url = context.payload.discussion.html_url;
+            }
+            core.setOutput('url', url);
+
+      - name: Respond to discussion
+        if: steps.discussion-url.outputs.url != ''
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "discussions"
+          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

@@ -0,0 +1,98 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-flow-fix-code.yml
+#
+# Fix failing PRs via agentic-step.
+# Triggered when a check suite fails on an agentic or copilot branch.
+
+name: agent-flow-fix-code
+run-name: "agent-flow-fix-code [${{ github.ref_name }}]"
+
+on:
+  check_suite:
+    types:
+      - completed
+  workflow_dispatch:
+    inputs:
+      pr-number:
+        description: "PR number to fix"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  pull-requests: write
+  checks: read
+
+env:
+  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+
+jobs:
+  find-failing-pr:
+    if: >
+      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, 'copilot/')))
+    runs-on: ubuntu-latest
+    outputs:
+      prNumber: ${{ steps.find-pr.outputs.prNumber }}
+    steps:
+      - name: Find PR from check suite or input
+        id: find-pr
+        uses: actions/github-script@v7
+        with:
+          script: |
+            let prNumber = '${{ inputs.pr-number }}';
+            if (!prNumber && context.payload.check_suite) {
+              const branch = context.payload.check_suite.head_branch;
+              const { data: prs } = await github.rest.pulls.list({
+                ...context.repo,
+                state: 'open',
+                head: `${context.repo.owner}:${branch}`,
+                per_page: 1,
+              });
+              prNumber = prs.length > 0 ? String(prs[0].number) : '';
+            }
+            core.setOutput('prNumber', prNumber);
+
+  fix:
+    needs: find-failing-pr
+    if: needs.find-failing-pr.outputs.prNumber != ''
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Checkout PR branch
+        run: |
+          gh pr checkout ${{ needs.find-failing-pr.outputs.prNumber }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Fix failing code
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "fix-code"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-apply-fix.md"
+          pr-number: ${{ needs.find-failing-pr.outputs.prNumber }}
+          test-command: "npm test"
+
+      - name: Commit and push fixes
+        uses: ./.github/agentic-lib/actions/commit-if-changed
+        with:
+          commit-message: "agentic-step: fix failing tests"

package/src/workflows/agent-flow-maintain.yml

@@ -0,0 +1,114 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-flow-maintain.yml
+#
+# Feature + library + source maintenance.
+# Runs periodically to keep the knowledge base and features up to date.
+
+name: agent-flow-maintain
+run-name: "agent-flow-maintain [${{ github.ref_name }}]"
+concurrency: agentic-lib-main
+
+on:
+  schedule:
+    - cron: "33 7 * * 1" # Weekly on Monday at 07:33 UTC
+  workflow_dispatch:
+    inputs:
+      step:
+        description: "Which maintenance step to run"
+        required: false
+        default: "all"
+        type: choice
+        options:
+          - all
+          - features
+          - library
+
+permissions:
+  contents: write
+  issues: write
+
+env:
+  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+
+jobs:
+  maintain-features:
+    if: inputs.step == 'all' || inputs.step == 'features' || github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Load config for features
+        id: features-config
+        run: |
+          CONFIG="${{ env.configPath }}"
+          FEATURES=$(yq -r '.paths.featuresPath.path // ".github/agentic-lib/features/"' "$CONFIG")
+          echo "writablePaths=${FEATURES}" >> $GITHUB_OUTPUT
+
+      - name: Maintain features
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "maintain-features"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-maintain-features.md"
+          writable-paths: ${{ steps.features-config.outputs.writablePaths }}
+
+      - name: Commit and push changes
+        uses: ./.github/agentic-lib/actions/commit-if-changed
+        with:
+          commit-message: "agentic-step: maintain-features"
+          push-ref: ${{ github.ref_name }}
+
+  maintain-library:
+    if: inputs.step == 'all' || inputs.step == 'library' || github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Load config for library
+        id: library-config
+        run: |
+          CONFIG="${{ env.configPath }}"
+          LIBRARY=$(yq -r '.paths.libraryDocumentsPath.path // "library/"' "$CONFIG")
+          SOURCES=$(yq -r '.paths.librarySourcesFilepath.path // "SOURCES.md"' "$CONFIG")
+          echo "writablePaths=${LIBRARY};${SOURCES}" >> $GITHUB_OUTPUT
+
+      - name: Maintain library
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "maintain-library"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-maintain-library.md"
+          writable-paths: ${{ steps.library-config.outputs.writablePaths }}
+
+      - name: Commit and push changes
+        uses: ./.github/agentic-lib/actions/commit-if-changed
+        with:
+          commit-message: "agentic-step: maintain-library"
+          push-ref: ${{ github.ref_name }}

package/src/workflows/agent-flow-review.yml

@@ -0,0 +1,99 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-flow-review.yml
+#
+# Close resolved issues, prune features, enhance issues with criteria.
+
+name: agent-flow-review
+run-name: "agent-flow-review [${{ github.ref_name }}]"
+concurrency: agentic-lib-main
+
+on:
+  schedule:
+    - cron: "47 8 */3 * *" # Every 3 days at 08:47 UTC
+  workflow_dispatch:
+    inputs:
+      step:
+        description: "Which review step to run"
+        required: false
+        default: "all"
+        type: choice
+        options:
+          - all
+          - review
+          - enhance
+
+permissions:
+  contents: read
+  issues: write
+
+env:
+  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+
+jobs:
+  review-issues:
+    if: inputs.step == 'all' || inputs.step == 'review' || github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Review issues
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "review-issue"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-review-issue.md"
+
+  enhance-issues:
+    if: inputs.step == 'all' || inputs.step == 'enhance' || github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Find issue to enhance
+        id: find-issue
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: issues } = await github.rest.issues.listForRepo({
+              ...context.repo,
+              state: 'open',
+              labels: 'automated',
+              per_page: 1,
+              sort: 'created',
+              direction: 'asc',
+            });
+            const unready = issues.filter(i => !i.labels.some(l => l.name === 'ready'));
+            core.setOutput('issueNumber', unready.length > 0 ? String(unready[0].number) : '');
+
+      - name: Install agentic-step dependencies
+        if: steps.find-issue.outputs.issueNumber != ''
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Enhance issue
+        if: steps.find-issue.outputs.issueNumber != ''
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "enhance-issue"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-ready-issue.md"
+          issue-number: ${{ steps.find-issue.outputs.issueNumber }}

package/src/workflows/agent-flow-transform.yml

@@ -0,0 +1,82 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-flow-transform.yml
+#
+# Autonomous code transformation: Mission → Features → Issues → Code → PR
+# Replaces the 10 transformation workflows with a single agentic-step call.
+
+name: agent-flow-transform
+run-name: "agent-flow-transform [${{ github.ref_name }}]"
+concurrency: agentic-lib-main
+
+on:
+  schedule:
+    - cron: "17 6,8,10,12 * * *" # daily at 06:17 UTC
+  workflow_dispatch:
+    inputs:
+      model:
+        description: "Copilot SDK model to use"
+        type: choice
+        required: false
+        default: "claude-sonnet-4"
+        options:
+          - claude-sonnet-4
+          - gpt-5-mini
+          - gpt-4.1
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+env:
+  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+
+jobs:
+  transform:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        run: npm ci
+
+      - name: Load config
+        id: config
+        run: |
+          CONFIG="${{ env.configPath }}"
+          SOURCE=$(yq -r '.paths.targetSourcePath.path // "src/lib/"' "$CONFIG")
+          TESTS=$(yq -r '.paths.targetTestsPath.path // "tests/unit/"' "$CONFIG")
+          FEATURES=$(yq -r '.paths.featuresPath.path // ".github/agentic-lib/features/"' "$CONFIG")
+          DOCS=$(yq -r '.paths.documentationPath.path // "docs/"' "$CONFIG")
+          LIBRARY=$(yq -r '.paths.libraryDocumentsPath.path // "library/"' "$CONFIG")
+          SOURCES=$(yq -r '.paths.librarySourcesFilepath.path // "SOURCES.md"' "$CONFIG")
+          README=$(yq -r '.paths.readmeFilepath.path // "README.md"' "$CONFIG")
+          DEPS=$(yq -r '.paths.dependenciesFilepath.path // "package.json"' "$CONFIG")
+          echo "writablePaths=${SOURCE};${TESTS};${FEATURES};${DOCS};${LIBRARY};${SOURCES};${README};${DEPS}" >> $GITHUB_OUTPUT
+
+      - name: Run transformation step
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "transform"
+          config: ${{ env.configPath }}
+          instructions: ".github/agentic-lib/agents/agent-issue-resolution.md"
+          test-command: "npm test"
+          model: ${{ inputs.model || 'claude-sonnet-4' }}
+          writable-paths: ${{ steps.config.outputs.writablePaths }}
+
+      - name: Commit and push changes
+        uses: ./.github/agentic-lib/actions/commit-if-changed
+        with:
+          commit-message: "agentic-step: transform"
+          push-ref: ${{ github.ref_name }}

package/src/workflows/agent-supervisor.yml

@@ -0,0 +1,85 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agent-supervisor.yml
+#
+# Reactive orchestration — triggers workflows based on telemetry.
+# When a build fails, dispatches fix-code. When issues pile up, dispatches review.
+
+name: agent-supervisor
+run-name: "agent-supervisor [${{ github.ref_name }}]"
+
+on:
+  workflow_run:
+    workflows:
+      - ci
+      - agent-flow-transform
+      - agent-flow-maintain
+    types:
+      - completed
+  workflow_dispatch:
+
+permissions:
+  actions: write
+  contents: read
+  issues: read
+  checks: read
+
+jobs:
+  evaluate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check telemetry and dispatch
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const workflowRun = context.payload.workflow_run;
+
+            // If a workflow failed, trigger fix-code
+            if (workflowRun && workflowRun.conclusion === 'failure') {
+              const branch = workflowRun.head_branch;
+              const isAgenticBranch = !['main', 'master'].includes(branch);
+
+              if (isAgenticBranch) {
+                core.info(`Workflow "${workflowRun.name}" failed on branch ${branch}. Dispatching fix-code.`);
+
+                // Find the PR for this branch
+                const { data: prs } = await github.rest.pulls.list({
+                  ...context.repo,
+                  state: 'open',
+                  head: `${context.repo.owner}:${branch}`,
+                  per_page: 1,
+                });
+
+                if (prs.length > 0) {
+                  await github.rest.actions.createWorkflowDispatch({
+                    ...context.repo,
+                    workflow_id: 'agent-flow-fix-code.yml',
+                    ref: context.ref,
+                    inputs: { 'pr-number': String(prs[0].number) },
+                  });
+                  core.info(`Dispatched fix-code for PR #${prs[0].number}`);
+                }
+              }
+            }
+
+            // Check for stale issues (open > 14 days with no activity)
+            const { data: issues } = await github.rest.issues.listForRepo({
+              ...context.repo,
+              state: 'open',
+              labels: 'automated',
+              sort: 'updated',
+              direction: 'asc',
+              per_page: 5,
+            });
+
+            const fourteenDaysAgo = new Date(Date.now() - 14 * 24 * 60 * 60 * 1000);
+            const staleIssues = issues.filter(i => new Date(i.updated_at) < fourteenDaysAgo);
+
+            if (staleIssues.length > 0) {
+              core.info(`Found ${staleIssues.length} stale issue(s). Dispatching review.`);
+              await github.rest.actions.createWorkflowDispatch({
+                ...context.repo,
+                workflow_id: 'agent-flow-review.yml',
+                ref: context.ref,
+              });
+            }