@xn-intenton-z2a/agentic-lib 7.1.33 → 7.1.35

package/bin/agentic-lib.js

@@ -248,6 +248,7 @@ async function loadTaskConfig() {
     featuresPath: toml.paths?.features || "features/",
     libraryPath: toml.paths?.docs || "library/",
     sourcesPath: toml.paths?.["library-sources"] || "SOURCES.md",
+    examplesPath: toml.paths?.examples || "examples/",
     readmePath: toml.paths?.readme || "README.md",
     depsPath: toml.paths?.dependencies || "package.json",
     buildScript: toml.execution?.build || "npm run build",
@@ -264,6 +265,7 @@ function getWritablePathsFromConfig(config) {
     config.testsPath,
     config.featuresPath,
     config.libraryPath,
+    config.examplesPath,
     config.readmePath,
     config.depsPath,
   ].filter(Boolean);
@@ -363,6 +365,11 @@ function buildTransformPrompt(config, pathsSection) {
       `## Current Source Files (${sourceFiles.length})`,
       ...sourceFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
       "",
+      "## Output Artifacts",
+      "If your changes produce output artifacts (plots, visualizations, data files, usage examples),",
+      `save them to the \`${config.examplesPath || "examples/"}\` directory.`,
+      "This directory is for demonstrating what the code can do.",
+      "",
       "## Your Task",
       "Analyze the mission, features, and source code.",
       "Determine the single most impactful next step.",
@@ -736,6 +743,14 @@ function initConfig(seedsDir) {
   } else {
     console.log("  SKIP: seed TOML not found");
   }
+
+  const giSeed = resolve(seedsDir, "zero-.gitignore");
+  const giTarget = resolve(target, ".gitignore");
+  if (existsSync(giSeed) && !existsSync(giTarget)) {
+    initCopyFile(giSeed, giTarget, ".gitignore (new)");
+  } else if (existsSync(giTarget)) {
+    console.log("  SKIP: .gitignore already exists");
+  }
 }
 
 function removeFile(filePath, label) {
@@ -769,6 +784,7 @@ function initReseed() {
   }
 
   clearDirContents(resolve(target, "library"), "library");
+  clearDirContents(resolve(target, "examples"), "examples");
 
   // Remove old getting-started-guide if it exists
   const oldGuideDir = resolve(target, ".github/agentic-lib/getting-started-guide");
@@ -782,19 +798,22 @@ function initReseed() {
 function readTomlPaths() {
   let sourcePath = "src/lib/";
   let testsPath = "tests/unit/";
+  let examplesPath = "examples/";
   const tomlTarget = resolve(target, "agentic-lib.toml");
   if (existsSync(tomlTarget)) {
     try {
       const tomlContent = readFileSync(tomlTarget, "utf8");
       const sourceMatch = tomlContent.match(/^source\s*=\s*"([^"]+)"/m);
       const testsMatch = tomlContent.match(/^tests\s*=\s*"([^"]+)"/m);
+      const examplesMatch = tomlContent.match(/^examples\s*=\s*"([^"]+)"/m);
       if (sourceMatch) sourcePath = sourceMatch[1];
       if (testsMatch) testsPath = testsMatch[1];
+      if (examplesMatch) examplesPath = examplesMatch[1];
     } catch (err) {
       console.log(`  WARN: Could not read TOML for paths, using defaults: ${err.message}`);
     }
   }
-  return { sourcePath, testsPath };
+  return { sourcePath, testsPath, examplesPath };
 }
 
 function clearAndRecreateDir(dirPath, label) {
@@ -810,9 +829,10 @@ function clearAndRecreateDir(dirPath, label) {
 function initPurge(seedsDir) {
   console.log("\n--- Purge: Reset Source Files to Seed State ---");
 
-  const { sourcePath, testsPath } = readTomlPaths();
+  const { sourcePath, testsPath, examplesPath } = readTomlPaths();
   clearAndRecreateDir(sourcePath, sourcePath);
   clearAndRecreateDir(testsPath, testsPath);
+  clearAndRecreateDir(examplesPath, examplesPath);
 
   // Copy seed files (including config TOML)
   const SEED_MAP = {
@@ -823,6 +843,7 @@ function initPurge(seedsDir) {
     "zero-package.json": "package.json",
     "zero-README.md": "README.md",
     "zero-agentic-lib.toml": "agentic-lib.toml",
+    "zero-.gitignore": ".gitignore",
   };
   for (const [seedFile, targetRel] of Object.entries(SEED_MAP)) {
     const src = resolve(seedsDir, seedFile);

package/package.json

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

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

@@ -35,7 +35,7 @@ import { parse as parseToml } from "smol-toml";
  */
 
 // Keys whose paths are writable by agents
-const WRITABLE_KEYS = ["source", "tests", "features", "dependencies", "docs", "readme"];
+const WRITABLE_KEYS = ["source", "tests", "features", "dependencies", "docs", "readme", "examples"];
 
 // Default paths — every key that task handlers might access
 const PATH_DEFAULTS = {
@@ -44,6 +44,7 @@ const PATH_DEFAULTS = {
   tests: "tests/unit/",
   features: "features/",
   docs: "docs/",
+  examples: "examples/",
   readme: "README.md",
   dependencies: "package.json",
   library: "library/",

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

@@ -85,8 +85,10 @@ async function run() {
       github: github.context,
     };
 
-    // Run the task
+    // Run the task (measure wall-clock duration for cost tracking)
+    const startTime = Date.now();
     const result = await handler(context);
+    const durationMs = Date.now() - startTime;
 
     // Set outputs
     core.setOutput("result", result.outcome || "completed");
@@ -108,6 +110,7 @@ async function run() {
         inputTokens: result.inputTokens,
         outputTokens: result.outputTokens,
         cost: result.cost,
+        durationMs,
         model: result.model || model,
         details: result.details,
         workflowUrl: `${process.env.GITHUB_SERVER_URL}/${github.context.repo.owner}/${github.context.repo.repo}/actions/runs/${github.context.runId}`,

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

@@ -22,7 +22,8 @@ import * as core from "@actions/core";
  * @param {number} [options.tokensUsed] - Total tokens consumed (input + output)
  * @param {number} [options.inputTokens] - Input tokens consumed
  * @param {number} [options.outputTokens] - Output tokens consumed
- * @param {number} [options.cost] - Cost reported by Copilot SDK
+ * @param {number} [options.cost] - Model invocations (from Copilot SDK)
+ * @param {number} [options.durationMs] - Task wall-clock duration in milliseconds
  * @param {string} [options.model] - Model used
  * @param {string} [options.details] - Additional details
  * @param {string} [options.workflowUrl] - URL to the workflow run
@@ -38,6 +39,7 @@ export function logActivity({
   inputTokens,
   outputTokens,
   cost,
+  durationMs,
   model,
   details,
   workflowUrl,
@@ -54,8 +56,13 @@ export function logActivity({
   if (prNumber) parts.push(`**PR:** #${prNumber}`);
   if (commitUrl) parts.push(`**Commit:** [${commitUrl}](${commitUrl})`);
   if (model) parts.push(`**Model:** ${model}`);
-  if (tokensUsed) parts.push(`**Tokens:** ${tokensUsed} (in: ${inputTokens || 0}, out: ${outputTokens || 0})`);
-  if (cost) parts.push(`**Cost:** ${cost}`);
+  if (tokensUsed) parts.push(`**Token Count:** ${tokensUsed} (in: ${inputTokens || 0}, out: ${outputTokens || 0})`);
+  if (cost) parts.push(`**Model Invocations:** ${cost}`);
+  if (durationMs) {
+    const secs = Math.round(durationMs / 1000);
+    const mins = (durationMs / 60000).toFixed(1);
+    parts.push(`**Duration:** ${secs}s (~${mins} GitHub Actions min)`);
+  }
   if (workflowUrl) parts.push(`**Workflow:** [${workflowUrl}](${workflowUrl})`);
   if (details) {
     parts.push("");

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

@@ -72,6 +72,11 @@ export async function transform(context) {
     `## Open Issues (${openIssues.length})`,
     ...openIssues.slice(0, 10).map((i) => `- #${i.number}: ${i.title}`),
     "",
+    "## Output Artifacts",
+    "If your changes produce output artifacts (plots, visualizations, data files, usage examples),",
+    `save them to the \`${config.paths.examples?.path || "examples/"}\` directory.`,
+    "This directory is for demonstrating what the code can do.",
+    "",
     "## Your Task",
     "Analyze the mission, features, source code, and open issues.",
     "Determine the single most impactful next step to transform this repository.",
@@ -190,6 +195,11 @@ async function transformTdd({
     "",
     formatPathsSection(writablePaths, readOnlyPaths),
     "",
+    "## Output Artifacts",
+    "If your changes produce output artifacts (plots, visualizations, data files, usage examples),",
+    `save them to the \`${_config.paths.examples?.path || "examples/"}\` directory.`,
+    "This directory is for demonstrating what the code can do.",
+    "",
     "## Constraints",
     "- Write implementation code to make the failing test pass",
     "- Do NOT modify the test file created in Phase 1",

package/src/agents/agent-maintain-features.md

@@ -1,7 +1,7 @@
 Please generate the name and specification for a software feature which will be added or updated to action the supplied feature prompt.
 Prioritize features that deliver substantial user impact and core functionality that solves real problems. Focus on capabilities that directly enhance the product's primary purpose rather than cosmetic improvements, excessive validation, or polishing. Aim for achievable, high-impact outcomes within a single repository, not a grandiose vision or bloated feature set.
 
-You may only create features to only change the source file, test file, README file and dependencies file content. You may not create features that request new files, delete existing files, or change the other files provided in the prompt context.
+You may only create features to only change the source file, test file, README file, dependencies file, and examples directory content. You may not create features that request new files, delete existing files, or change the other files provided in the prompt context.
 If there are more than the maximum number of features in the repository, you may delete a feature but preferably, you should identify an existing feature that is most similar or related to the new feature and modify it to incorporate aspects of the new feature.
 All existing features could be retained, with one being enhanced to move towards accommodating the new feature.
 

package/src/seeds/zero-.gitignore

@@ -0,0 +1,27 @@
+# Node
+node_modules/
+
+# Coverage
+coverage/
+
+# Environment and secrets
+.env
+secrets.env
+*.kdbx
+.npmrc
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Generated files at repo root (agents should use examples/ instead)
+/*.png
+/*.svg
+/*.pdf
+/*.csv

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

@@ -16,6 +16,7 @@ tests = "tests/unit/"
 features = "features/"
 library = "library/"
 docs = "docs/"
+examples = "examples/"
 readme = "README.md"
 dependencies = "package.json"
 contributing = "CONTRIBUTING.md"

package/src/seeds/zero-package.json

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