@xn-intenton-z2a/agentic-lib 7.1.41 → 7.1.43

package/bin/agentic-lib.js

@@ -958,6 +958,52 @@ function initPurgeGitHub() {
   } catch {
     console.log("  SKIP: Could not list discussions (feature may not be enabled)");
   }
+
+  // Create a new "Talk to the repository" discussion
+  try {
+    // Get the repository node ID and "General" category ID
+    const repoQuery = JSON.stringify({
+      query: `{ repository(owner:"${owner}", name:"${repo}") { id discussionCategories(first:20) { nodes { id name } } } }`,
+    });
+    const repoResult = execSync(`gh api graphql --input -`, {
+      cwd: target,
+      encoding: "utf8",
+      timeout: 30000,
+      input: repoQuery,
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    const repoParsed = JSON.parse(repoResult);
+    const repoId = repoParsed?.data?.repository?.id;
+    const categories = repoParsed?.data?.repository?.discussionCategories?.nodes || [];
+    const generalCat = categories.find((c) => c.name === "General");
+    if (!repoId || !generalCat) {
+      console.log('  SKIP: Could not find repository ID or "General" discussion category');
+    } else {
+      console.log('  CREATE: discussion "Talk to the repository" in General category');
+      if (!dryRun) {
+        const createMutation = JSON.stringify({
+          query: `mutation { createDiscussion(input: { repositoryId: "${repoId}", categoryId: "${generalCat.id}", title: "Talk to the repository", body: "This discussion is the main channel for interacting with the repository's autonomous agents.\\n\\nUse this thread to:\\n- Submit feature requests or ideas\\n- Ask questions about the project\\n- Chat with the discussions bot\\n\\n---\\n*Created by init --purge*" }) { discussion { number url } } }`,
+        });
+        const createResult = execSync(`gh api graphql --input -`, {
+          cwd: target,
+          encoding: "utf8",
+          timeout: 15000,
+          input: createMutation,
+          stdio: ["pipe", "pipe", "pipe"],
+        });
+        const createParsed = JSON.parse(createResult);
+        const newDisc = createParsed?.data?.createDiscussion?.discussion;
+        if (newDisc) {
+          console.log(`  CREATED: discussion #${newDisc.number} — ${newDisc.url}`);
+          initChanges++;
+        }
+      } else {
+        initChanges++;
+      }
+    }
+  } catch (err) {
+    console.log(`  SKIP: Could not create discussion (${err.message})`);
+  }
 }
 
 function runInit() {

package/package.json

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

package/src/actions/agentic-step/config-loader.js

@@ -60,6 +60,22 @@ const LIMIT_DEFAULTS = {
   library: 32,
 };
 
+/**
+ * Read package.json from the project root, returning empty string if not found.
+ * @param {string} tomlPath - Path to the TOML config (used to derive project root)
+ * @param {string} depsRelPath - Relative path to package.json (from config)
+ * @returns {string} Raw package.json content or empty string
+ */
+function readPackageJson(tomlPath, depsRelPath) {
+  try {
+    const projectRoot = dirname(tomlPath);
+    const pkgPath = join(projectRoot, depsRelPath);
+    return existsSync(pkgPath) ? readFileSync(pkgPath, "utf8") : "";
+  } catch {
+    return "";
+  }
+}
+
 /**
  * Load configuration from agentic-lib.toml.
  *
@@ -85,7 +101,8 @@ export function loadConfig(configPath) {
     throw new Error(`Config file not found: ${tomlPath}. Create agentic-lib.toml in the project root.`);
   }
 
-  const toml = parseToml(readFileSync(tomlPath, "utf8"));
+  const rawToml = readFileSync(tomlPath, "utf8");
+  const toml = parseToml(rawToml);
 
   // Merge TOML paths with defaults, normalising library-sources → librarySources
   const rawPaths = { ...toml.paths };
@@ -136,6 +153,8 @@ export function loadConfig(configPath) {
     tdd: toml.tdd === true,
     writablePaths,
     readOnlyPaths,
+    configToml: rawToml,
+    packageJson: readPackageJson(tomlPath, mergedPaths.dependencies),
   };
 }
 

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

@@ -171,15 +171,25 @@ export function scanDirectory(dirPath, extensions, options = {}) {
  *
  * @param {string[]} writablePaths
  * @param {string[]} [readOnlyPaths=[]]
+ * @param {Object} [contextFiles] - Optional raw file contents to include
+ * @param {string} [contextFiles.configToml] - Raw agentic-lib.toml text
+ * @param {string} [contextFiles.packageJson] - Raw package.json text
  * @returns {string}
  */
-export function formatPathsSection(writablePaths, readOnlyPaths = []) {
-  return [
+export function formatPathsSection(writablePaths, readOnlyPaths = [], contextFiles) {
+  const lines = [
     "## File Paths",
     "### Writable (you may modify these)",
     writablePaths.length > 0 ? writablePaths.map((p) => `- ${p}`).join("\n") : "- (none)",
     "",
     "### Read-Only (for context only, do NOT modify)",
     readOnlyPaths.length > 0 ? readOnlyPaths.map((p) => `- ${p}`).join("\n") : "- (none)",
-  ].join("\n");
+  ];
+  if (contextFiles?.configToml) {
+    lines.push("", "### Configuration (agentic-lib.toml)", "```toml", contextFiles.configToml, "```");
+  }
+  if (contextFiles?.packageJson) {
+    lines.push("", "### Dependencies (package.json)", "```json", contextFiles.packageJson, "```");
+  }
+  return lines.join("\n");
 }

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

@@ -100,6 +100,8 @@ function buildPrompt(discussionUrl, discussion, context) {
     contributing ? `### Contributing\n${contributing}` : "",
     `### Current Features\n${featureNames.join(", ") || "none"}`,
     recentActivity ? `### Recent Activity\n${recentActivity}` : "",
+    config.configToml ? `### Configuration (agentic-lib.toml)\n\`\`\`toml\n${config.configToml}\n\`\`\`` : "",
+    config.packageJson ? `### Dependencies (package.json)\n\`\`\`json\n${config.packageJson}\n\`\`\`` : "",
     "",
     "## Actions",
     "Include exactly one action tag in your response. Only mention actions to the user when relevant.",

package/src/actions/agentic-step/tasks/enhance-issue.js

@@ -49,6 +49,8 @@ export async function enhanceIssue(context) {
     "",
     contributing ? `## Contributing Guidelines\n${contributing.substring(0, 1000)}` : "",
     features.length > 0 ? `## Related Features\n${features.map((f) => f.content).join("\n---\n")}` : "",
+    config.configToml ? `## Configuration (agentic-lib.toml)\n\`\`\`toml\n${config.configToml}\n\`\`\`` : "",
+    config.packageJson ? `## Dependencies (package.json)\n\`\`\`json\n${config.packageJson}\n\`\`\`` : "",
     "",
     "## Your Task",
     "Write an enhanced version of this issue body that includes:",

package/src/actions/agentic-step/tasks/fix-code.js

@@ -46,7 +46,7 @@ export async function fixCode(context) {
     "## Failing Checks",
     failureDetails,
     "",
-    formatPathsSection(writablePaths, readOnlyPaths),
+    formatPathsSection(writablePaths, readOnlyPaths, config),
     "",
     "## Constraints",
     `- Run \`${testCommand}\` to validate your fixes`,

package/src/actions/agentic-step/tasks/maintain-features.js

@@ -55,7 +55,7 @@ export async function maintainFeatures(context) {
     `2. If there are fewer than ${featureLimit} features, create new features aligned with the mission.`,
     "3. Ensure each feature has clear, testable acceptance criteria.",
     "",
-    formatPathsSection(writablePaths, config.readOnlyPaths),
+    formatPathsSection(writablePaths, config.readOnlyPaths, config),
     "",
     "## Constraints",
     `- Maximum ${featureLimit} feature files`,

package/src/actions/agentic-step/tasks/maintain-library.js

@@ -44,7 +44,7 @@ export async function maintainLibrary(context) {
     "2. Create or update library documents based on the source content.",
     "3. Remove library documents that no longer have corresponding sources.",
     "",
-    formatPathsSection(writablePaths, config.readOnlyPaths),
+    formatPathsSection(writablePaths, config.readOnlyPaths, config),
     "",
     "## Constraints",
     `- Maximum ${libraryLimit} library documents`,

package/src/actions/agentic-step/tasks/resolve-issue.js

@@ -71,7 +71,7 @@ export async function resolveIssue(context) {
     comments.length > 0 ? "## Issue Comments" : "",
     ...comments.map((c) => `**${c.user.login}:** ${c.body}`),
     "",
-    formatPathsSection(writablePaths, readOnlyPaths),
+    formatPathsSection(writablePaths, readOnlyPaths, config),
     "",
     "## Constraints",
     `- Run \`${testCommand}\` to validate your changes`,

package/src/actions/agentic-step/tasks/review-issue.js

@@ -87,6 +87,9 @@ export async function reviewIssue(context) {
     `## Current Tests (${testFiles.length} files)`,
     ...testFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
+    config.configToml ? `## Configuration (agentic-lib.toml)\n\`\`\`toml\n${config.configToml}\n\`\`\`` : "",
+    config.packageJson ? `## Dependencies (package.json)\n\`\`\`json\n${config.packageJson}\n\`\`\`` : "",
+    "",
     "## Your Task",
     "Determine if this issue has been resolved by the current code.",
     "Respond with exactly one of:",

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

@@ -75,6 +75,8 @@ async function gatherContext(octokit, repo, config) {
     prsSummary,
     workflowsSummary,
     supervisor: config.supervisor,
+    configToml: config.configToml,
+    packageJson: config.packageJson,
     featureIssuesWipLimit: config.featureDevelopmentIssuesWipLimit,
     maintenanceIssuesWipLimit: config.maintenanceIssuesWipLimit,
   };
@@ -109,6 +111,12 @@ function buildPrompt(ctx, agentInstructions) {
     "",
     `### Supervisor: ${ctx.supervisor}`,
     "",
+    "### Configuration (agentic-lib.toml)",
+    "```toml",
+    ctx.configToml || "",
+    "```",
+    "",
+    ...(ctx.packageJson ? ["### Dependencies (package.json)", "```json", ctx.packageJson, "```", ""] : []),
     `### Issue Limits`,
     `Feature development WIP limit: ${ctx.featureIssuesWipLimit}`,
     `Maintenance WIP limit: ${ctx.maintenanceIssuesWipLimit}`,
@@ -123,6 +131,7 @@ function buildPrompt(ctx, agentInstructions) {
     "- `dispatch:agent-flow-review` — Close resolved issues, enhance issue criteria",
     "- `dispatch:agent-flow-fix-code | pr-number: <N>` — Fix a failing PR",
     "- `dispatch:agent-discussions-bot` — Proactively post in discussions",
+    "- `dispatch:ci-automerge` — Merge open PRs with the automerge label if checks pass",
     "",
     "### GitHub API Actions",
     "- `github:create-issue | title: <text> | labels: <comma-separated>` — Create a new issue",

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

@@ -82,7 +82,7 @@ export async function transform(context) {
     "Determine the single most impactful next step to transform this repository.",
     "Then implement that step.",
     "",
-    formatPathsSection(writablePaths, readOnlyPaths),
+    formatPathsSection(writablePaths, readOnlyPaths, config),
     "",
     "## Constraints",
     `- Run \`${testCommand}\` to validate your changes`,
@@ -153,7 +153,7 @@ async function transformTdd({
     `## Open Issues (${openIssues.length})`,
     ...openIssues.slice(0, 10).map((i) => `- #${i.number}: ${i.title}`),
     "",
-    formatPathsSection(writablePaths, readOnlyPaths),
+    formatPathsSection(writablePaths, readOnlyPaths, _config),
     "",
     "## Constraints",
     "- Write ONLY test code in this phase",
@@ -193,7 +193,7 @@ async function transformTdd({
     `## Current Source Files (${sourceFiles.length})`,
     ...sourceFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
-    formatPathsSection(writablePaths, readOnlyPaths),
+    formatPathsSection(writablePaths, readOnlyPaths, _config),
     "",
     "## Output Artifacts",
     "If your changes produce output artifacts (plots, visualizations, data files, usage examples),",

package/src/agents/agent-supervisor.md

@@ -23,6 +23,7 @@ You are the supervisor of an autonomous coding repository. Your job is to advanc
 - **dispatch:agent-flow-fix-code** — When a specific PR has failing checks. Always include the pr-number.
 - **dispatch:agent-flow-maintain** — When features are below their limit AND no maintain appears in the last 3 workflow runs.
 - **dispatch:agent-discussions-bot** — When you want to proactively engage in discussions or respond to a user request.
+- **dispatch:ci-automerge** — When open PRs with the `automerge` label appear ready to merge but no merge activity shows in recent runs. Recovery action — ci-automerge normally fires on event triggers.
 - **github:label-issue** — When an issue needs better categorisation for prioritisation.
 - **github:close-issue** — When an issue is clearly resolved or no longer relevant.
 - **respond:discussions** — When replying to a user request that came through the discussions bot. Include the discussion URL and a clear message.

package/src/seeds/init.yml

@@ -109,6 +109,8 @@ jobs:
         run: npm update @xn-intenton-z2a/agentic-lib
 
       - name: Run init
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           FLAGS="init"
           if [ "$INIT_MODE" = "reseed" ]; then FLAGS="$FLAGS --reseed"; fi

package/src/seeds/zero-package.json

@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.41"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.43"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.0",

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

@@ -22,8 +22,6 @@ on:
     types:
       - created
       - edited
-  schedule:
-    - cron: "7 12 */28 * *"
   workflow_dispatch:
     inputs:
       discussion-url:

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

@@ -12,8 +12,6 @@ concurrency:
   cancel-in-progress: true
 
 on:
-  schedule:
-    - cron: "33 7 * * 1"
   workflow_dispatch:
     inputs:
       step:

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

@@ -11,8 +11,6 @@ concurrency:
   cancel-in-progress: true
 
 on:
-  schedule:
-    - cron: "47 8 */3 * *"
   workflow_dispatch:
     inputs:
       step:

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

@@ -12,8 +12,6 @@ concurrency:
   cancel-in-progress: true
 
 on:
-  schedule:
-    - cron: "33 8 * * 1"
   workflow_dispatch:
     inputs:
       model:

package/src/workflows/ci-automerge.yml

@@ -25,8 +25,6 @@ on:
         type: string
         required: false
         default: "true"
-  schedule:
-    - cron: "03 8,9 * * 1"
 
 env:
   pullRequestLabel: "automerge"
@@ -154,7 +152,6 @@ jobs:
   ls:
     needs: label
     if: >-
-      github.event_name == 'schedule' ||
       github.event_name == 'workflow_dispatch' ||
       github.event_name == 'workflow_run' ||
       inputs.workflow == 'true' ||