@xn-intenton-z2a/agentic-lib 7.1.67 → 7.1.69

package/.github/workflows/agentic-lib-workflow.yml

@@ -721,15 +721,35 @@ jobs:
         run: |
           npm run build:web 2>/dev/null || echo "No build:web script"
 
+      - name: Run tests before committing
+        id: pre-commit-test
+        if: steps.issue.outputs.issue-number != ''
+        run: |
+          CONFIG="${{ needs.params.outputs.config-path }}"
+          TEST_CMD=$(grep -E '^\s*test\s*=' "$CONFIG" 2>/dev/null | sed 's/.*=\s*"\(.*\)"/\1/' | head -1)
+          TEST_CMD="${TEST_CMD:-npm ci && npm test}"
+          echo "Running: $TEST_CMD"
+          set +e
+          eval "$TEST_CMD" 2>&1 | tail -30
+          EXIT_CODE=$?
+          set -e
+          if [ $EXIT_CODE -ne 0 ]; then
+            echo "tests-passed=false" >> $GITHUB_OUTPUT
+            echo "WARNING: Tests failed (exit $EXIT_CODE) — skipping commit and PR"
+          else
+            echo "tests-passed=true" >> $GITHUB_OUTPUT
+            echo "Tests passed"
+          fi
+
       - name: Commit and push
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true' && steps.pre-commit-test.outputs.tests-passed == 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: transform issue #${{ steps.issue.outputs.issue-number }}"
           push-ref: ${{ steps.branch.outputs.branchName }}
 
       - name: Create PR and attempt merge
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true' && steps.pre-commit-test.outputs.tests-passed == 'true'
         uses: actions/github-script@v8
         with:
           script: |

package/agentic-lib.toml

@@ -70,7 +70,7 @@ infinite-sessions = false        # set to true for long sessions with compaction
 # Fast & cheap — CI testing, quick validation, budget-conscious iteration.
 reasoning-effort = "low"                # low | medium | high | none
 infinite-sessions = false               # enable session compaction for long runs
-transformation-budget = 4              # max code-changing cycles per run
+transformation-budget = 16             # max code-changing cycles per run
 max-feature-files = 3                      # max feature files included in prompts
 max-source-files = 3                        # max source files included in prompts
 max-source-chars = 1000                  # max chars of each source file's content included in prompts
@@ -91,7 +91,7 @@ library-limit = 8                      # max library entries in library/ directo
 # Balanced — good results without excessive cost. Default for consumer repos.
 reasoning-effort = "medium"            # low | medium | high | none
 infinite-sessions = true               # enable session compaction for long runs
-transformation-budget = 8             # max code-changing cycles per run
+transformation-budget = 32             # max code-changing cycles per run
 max-feature-files = 10                     # max feature files included in prompts
 max-source-files = 10                       # max source files included in prompts
 max-source-chars = 5000                  # max chars of each source file's content included in prompts
@@ -112,7 +112,7 @@ library-limit = 32                     # max library entries in library/ directo
 # Thorough — maximum context, highest quality. For complex missions.
 reasoning-effort = "high"              # low | medium | high | none
 infinite-sessions = true               # enable session compaction for long runs
-transformation-budget = 32            # max code-changing cycles per run
+transformation-budget = 128           # max code-changing cycles per run
 max-feature-files = 50                     # max feature files included in prompts
 max-source-files = 50                       # max source files included in prompts
 max-source-chars = 20000                 # max chars of each source file's content included in prompts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.67",
+  "version": "7.1.69",
   "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", "examples"];
+const WRITABLE_KEYS = ["source", "tests", "features", "dependencies", "docs", "readme", "examples", "web"];
 
 // Default paths — every key that task handlers might access
 const PATH_DEFAULTS = {
@@ -50,6 +50,7 @@ const PATH_DEFAULTS = {
   library: "library/",
   librarySources: "SOURCES.md",
   contributing: "CONTRIBUTING.md",
+  web: "src/web/",
 };
 
 // Default limits for path-specific constraints
@@ -63,7 +64,7 @@ const LIMIT_DEFAULTS = {
 const FALLBACK_TUNING = {
   reasoningEffort: "medium",
   infiniteSessions: true,
-  transformationBudget: 8,
+  transformationBudget: 32,
   featuresScan: 10,
   sourceScan: 10,
   sourceContent: 5000,
@@ -92,7 +93,7 @@ function parseTuningProfile(profileSection) {
   return {
     reasoningEffort: profileSection["reasoning-effort"] || "medium",
     infiniteSessions: profileSection["infinite-sessions"] ?? true,
-    transformationBudget: profileSection["transformation-budget"] || 8,
+    transformationBudget: profileSection["transformation-budget"] || 32,
     featuresScan: profileSection["max-feature-files"] || 10,
     sourceScan: profileSection["max-source-files"] || 10,
     sourceContent: profileSection["max-source-chars"] || 5000,

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

@@ -101,7 +101,7 @@ async function run() {
 
     // Compute limits status for enriched logging
     const limitsStatus = [
-      { name: "transformation-budget", valueNum: 0, capacityNum: config.transformationBudget || 0, value: `0/${config.transformationBudget || 0}`, remaining: `${config.transformationBudget || 0} remaining`, status: "" },
+      { name: "transformation-budget", valueNum: 0, capacityNum: config.transformationBudget || 0, value: `0/${config.transformationBudget || 0}`, remaining: `${config.transformationBudget || 0}`, status: "" },
       { name: "max-feature-issues", valueNum: 0, capacityNum: config.featureDevelopmentIssuesWipLimit, value: `?/${config.featureDevelopmentIssuesWipLimit}`, remaining: "?", status: "" },
       { name: "max-maintenance-issues", valueNum: 0, capacityNum: config.maintenanceIssuesWipLimit, value: `?/${config.maintenanceIssuesWipLimit}`, remaining: "?", status: "" },
       { name: "max-attempts-per-issue", valueNum: 0, capacityNum: config.attemptsPerIssue, value: `?/${config.attemptsPerIssue}`, remaining: "?", status: task === "resolve-issue" ? "" : "n/a" },
@@ -122,7 +122,7 @@ async function run() {
     const profileName = config.tuning?.profileName || "unknown";
 
     // Transformation cost: 1 for code-changing tasks, 0 otherwise
-    const COST_TASKS = ["transform", "fix-code"];
+    const COST_TASKS = ["transform", "fix-code", "maintain-features", "maintain-library"];
     const isNop = result.outcome === "nop" || result.outcome === "error";
     const transformationCost = COST_TASKS.includes(task) && !isNop ? 1 : 0;
 

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

@@ -46,6 +46,13 @@ async function reviewSingleIssue({ octokit, repo, config, targetIssueNumber, ins
     sortByMtime: true,
     clean: true,
   });
+  const webFiles = scanDirectory(config.paths.web?.path || "src/web/", [".html", ".css", ".js"], {
+    fileLimit: t.sourceScan || 20,
+    contentLimit: t.sourceContent || 5000,
+    recursive: true,
+    sortByMtime: true,
+    clean: true,
+  });
   const docsFiles = scanDirectory(config.paths.documentation?.path || "docs/", [".md"], {
     fileLimit: t.featuresScan || 10,
     contentLimit: t.documentSummary || 2000,
@@ -66,6 +73,14 @@ async function reviewSingleIssue({ octokit, repo, config, targetIssueNumber, ins
     `## Current Tests (${testFiles.length} files)`,
     ...testFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
+    ...(webFiles.length > 0
+      ? [
+          `## Website Files (${webFiles.length} files)`,
+          "The website in `src/web/` uses the JS library.",
+          ...webFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
+          "",
+        ]
+      : []),
     ...(docsFiles.length > 0
       ? [`## Documentation (${docsFiles.length} files)`, ...docsFiles.map((f) => `- ${f.name}`), ""]
       : []),

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

@@ -41,6 +41,13 @@ export async function transform(context) {
     clean: true,
     outline: true,
   });
+  const webFiles = scanDirectory(config.paths.web?.path || "src/web/", [".html", ".css", ".js"], {
+    fileLimit: t.sourceScan || 10,
+    contentLimit: t.sourceContent || 5000,
+    recursive: true,
+    sortByMtime: true,
+    clean: true,
+  });
 
   const { data: rawIssues } = await octokit.rest.issues.listForRepo({
     ...repo,
@@ -79,6 +86,7 @@ export async function transform(context) {
       mission,
       features,
       sourceFiles,
+      webFiles,
       openIssues,
       tuning: t,
     });
@@ -107,6 +115,16 @@ export async function transform(context) {
     `## Current Source Files (${sourceFiles.length})`,
     ...sourceFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
+    ...(webFiles.length > 0
+      ? [
+          `## Website Files (${webFiles.length})`,
+          "The website in `src/web/` uses the JS library.",
+          "When transforming source code, also update the website to use the library's new/changed features.",
+          "The `lib-meta.js` file (generated by `npm run build:web` from `package.json`) provides `name`, `version`, and `description` exports to the browser.",
+          ...webFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
+          "",
+        ]
+      : []),
     `## Open Issues (${openIssues.length})`,
     ...openIssues.slice(0, t.issuesScan || 20).map((i) => summariseIssue(i, t.issueBodyLimit || 500)),
     "",
@@ -202,6 +220,7 @@ async function transformTdd({
   mission,
   features,
   sourceFiles,
+  webFiles,
   openIssues,
   tuning: t,
 }) {
@@ -229,6 +248,14 @@ async function transformTdd({
     `## Current Source Files (${sourceFiles.length})`,
     ...sourceFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
+    ...(webFiles.length > 0
+      ? [
+          `## Website Files (${webFiles.length})`,
+          "The website in `src/web/` uses the JS library.",
+          ...webFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
+          "",
+        ]
+      : []),
     `## Open Issues (${openIssues.length})`,
     ...openIssues.slice(0, t.issuesScan || 20).map((i) => summariseIssue(i, t.issueBodyLimit || 500)),
     "",
@@ -273,6 +300,14 @@ async function transformTdd({
     `## Current Source Files (${sourceFiles.length})`,
     ...sourceFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
     "",
+    ...(webFiles.length > 0
+      ? [
+          `## Website Files (${webFiles.length})`,
+          "The website in `src/web/` uses the JS library. Update it to reflect any new features.",
+          ...webFiles.map((f) => `### ${f.name}\n\`\`\`\n${f.content}\n\`\`\``),
+          "",
+        ]
+      : []),
     formatPathsSection(writablePaths, readOnlyPaths, _config),
     "",
     "## Output Artifacts",

package/src/agents/agent-apply-fix.md

@@ -1,17 +1,20 @@
 You are providing the entire new content of source files, test files, documentation files,
 and other necessary files with all necessary changes applied to resolve a possible build or test
-problem. Focus on high-impact, functional fixes that address core issues rather than superficial
-changes or excessive debugging or validation. If the problem is in an area of the code with little
-value you may re-implement it or remove it.
+problem. Fix the root cause. If the problem is in an area of the code with little
+relevance to the mission you may re-implement it or remove it.
 
-Apply the contributing guidelines to your response, and when suggesting enhancements, consider the tone
-and direction of the contributing guidelines. Prioritize changes that deliver substantial user value
-and maintain the integrity of the codebase's primary purpose.
+Apply the contributing guidelines to your response.
 
 You may complete the implementation of a feature and/or bring the code output in line with the README
 or other documentation. Do as much as you can all at once so that the build runs (even with nothing
 to build) and the tests pass and the main at least doesn't output an error.
 
+Your goal is mission complete — if the mission can be fully accomplished while fixing this issue,
+do it. Don't limit yourself to the minimal fix when you can deliver the whole mission in one pass.
+
+The repository has a website in `src/web/` that uses the JS library. If a fix affects library
+exports or behaviour, also update the website files to stay in sync.
+
 ## Merge Conflict Resolution
 
 When resolving merge conflicts (files containing <<<<<<< / ======= / >>>>>>> markers):

package/src/agents/agent-discussion-bot.md

@@ -57,11 +57,11 @@ Users can ask for new features or mission changes through this discussion thread
 
 - **Feature requests** — When a user says "add feature X" or "I want Y", acknowledge the request and pass it to the supervisor to create a GitHub issue. The pipeline will pick it up and implement it.
 - **Re-seed requests** — When a user says "change the mission to Z" or "re-seed with plot-code-lib", explain that this requires running `npx @xn-intenton-z2a/agentic-lib init --purge --mission <name>`. List the available missions if asked: hamming-distance, fizz-buzz, roman-numerals, string-utils, dense-encoding, cron-engine, owl-ontology, plot-code-lib, time-series-lab, lunar-lander, empty. Note that re-seeding resets all source code, issues, and discussions.
-- **Website feedback** — The project has a website published via GitHub Pages. If a user comments on the website, pass feedback to the supervisor to create an issue for the pipeline to address.
+- **Website feedback** — The project has a website that uses the JS library, published via GitHub Pages. If a user comments on the website, pass feedback to the supervisor to create an issue for the pipeline to address.
 
 ## Website Awareness
 
-The repository publishes a website via GitHub Pages that showcases the library. The URL follows the pattern `https://<owner>.github.io/<repo>/`. When discussing the project, mention the website as a way for users to see the library in action.
+The repository publishes a website via GitHub Pages that uses the JS library. The URL follows the pattern `https://<owner>.github.io/<repo>/`. The website imports the library and displays its output. When discussing the project, mention the website as a way to see the library in action.
 
 ## Conversation Style
 

package/src/agents/agent-issue-resolution.md

@@ -1,14 +1,25 @@
 You are providing the entire new content of source files, test files, documentation files, and other necessary
-files with all necessary changes applied to deliver the resolution to an issue. Focus on high-impact,
-functional solutions that address core issues rather than superficial changes or excessive code polishing.
-Implement as much as you can and refer to the projects features and mission statement when expanding the code
+files with all necessary changes applied to deliver the resolution to an issue.
+Implement as much as you can and refer to the project's features and mission statement when expanding the code
 beyond the scope of the original issue. Implement whole features and do not leave stubbed out or pretended code.
 
-Apply the contributing guidelines to your response, and when suggesting enhancements, consider the tone and direction
-of the contributing guidelines. Prioritize changes that deliver user value and maintain the integrity
-of the codebase's primary purpose.
+Apply the contributing guidelines to your response.
 
-Do as much as you can all at once.
+Do as much as you can all at once. Your goal is mission complete — if the mission can be fully
+accomplished in this single transform, it should be. Deliver all acceptance criteria, tests, website,
+docs, and README in one pass. Only leave work for a follow-up if it genuinely cannot fit.
+
+## Tests Must Pass
+
+Your changes MUST leave all existing tests passing. If you change function signatures, return values, or
+output formats, you MUST also update the corresponding tests. The mission's acceptance criteria are the
+source of truth for expected values — if tests and acceptance criteria disagree, fix the tests to match
+the acceptance criteria and fix the code to pass those tests.
+
+When writing both tests and implementation:
+- Write tests that match the acceptance criteria in MISSION.md exactly (casing, types, error classes)
+- Ensure the implementation passes those tests before delivering
+- Do not write tests with different expectations than the implementation produces
 
 Follow the linting guidelines and the formatting guidelines from the included config.
 
@@ -22,16 +33,29 @@ When implementing features, also produce evidence artifacts under `docs/`:
 Design the library API with hooks that make evidence capture easy: return structured result objects,
 support `outputFile` options where appropriate, and emit results that observers can record.
 
-## Website Showcase
+## Website
+
+The repository has a website in `src/web/` that uses the JS library. It is published to GitHub Pages
+automatically (from `docs/` via `npm run build:web`).
+
+### How the library connects to the website
+
+- `src/lib/main.js` is the JS library — it exports functions, `name`, `version`, `description`, and `getIdentity()`
+- `npm run build:web` copies `src/web/*` to `docs/` and generates `docs/lib-meta.js` from `package.json`
+- `src/web/index.html` imports `lib-meta.js` via `<script type="module">` to display the library's identity
+- The website should import and call library functions — not just describe them
+
+### What to do with the website
+
+- **Use the library**: Import the library (or its browser-compatible parts) and call its functions on the page
+- **Show real results**: Display actual output from library functions, not placeholder text
+- When you add or change library functions, update the website to reflect them
 
-Maintain a website in `src/web/` that visually demonstrates the library's capabilities. The website is
-published to GitHub Pages automatically (from `docs/` via `npm run build:web`).
+### Guidelines
 
-- `src/web/index.html` is the main page — evolve it to showcase the library interactively
+- `src/web/index.html` is the main page — update it as the library grows
 - You may add CSS, JS, images, or additional HTML pages in `src/web/`
-- The website should demonstrate what the library does in a way a visitor can see and interact with
 - Keep it self-contained (no external CDN dependencies unless essential)
 - Link back to the repository for source code and mission details
-- When the library produces visual output (plots, graphs, data), embed or render it on the website
-- When the library is computational (algorithms, utilities), create an interactive demo or show example results
-- The website tests in `tests/unit/web.test.js` verify the HTML exists and is structurally valid — you may extend them
+- The website tests in `tests/unit/web.test.js` verify structure and library wiring — extend them as needed
+- The website is not the mission — it supports the library. Don't over-invest in the website at the expense of the library

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

@@ -1,5 +1,5 @@
 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.
+Features must advance the mission stated in MISSION.md. Aim for achievable 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, 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.
@@ -12,7 +12,7 @@ Don't use any quote escape sequences in the feature text.
 Generally, the whole document might need to be extracted and stored as JSON so be careful to avoid any JSON escape
 sequences in any part of the document. Use spacing to make it readable and avoid complex Markdown formatting.
 
-The feature will be iterated upon to incrementally deliver measurable value to users. Each iteration should focus on core functionality that addresses user needs rather than superficial enhancements. New features should be thematically distinct from other features.
+The feature will be iterated upon to incrementally advance the mission. New features should be thematically distinct from other features.
 If a significant feature of the repository is not present in the current feature set, please add it either to a new feature or an existing feature.
 Before adding a new feature ensure that this feature is distinct from any other feature in the repository, otherwise update an existing feature.
 When updating an existing feature, ensure that the existing aspects are not omitted in the response, provide the full feature spec.
@@ -27,3 +27,4 @@ Features must be achievable in a single software repository not part of a corpor
 The feature spec should be a multiline markdown with a few level 1 headings.
 The feature must be compatible with the mission statement in MISSION.md and ideally realise part of the value in the mission.
 The feature must be something that can be realised in a single source file (as below), ideally just as a library, CLI tool or possibly an HTTP API in combination with infrastructure as code deployment.
+The repository also has a website in `src/web/` that uses the JS library. When proposing features, consider both the library API and how the feature could be shown on the website.

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

@@ -1,19 +1,19 @@
-Extract and condense the most valuable and impactful technical details from the supplied crawl result. Focus on information that delivers substantial user value and addresses core implementation needs.
-Before adding a new document, ensure that this document is distinct from any other document in the library, otherwise update an existing document. Prioritize content that directly enhances the product's primary purpose rather than superficial or redundant information.
+Extract and condense the technical details from the supplied crawl result that are relevant to the mission.
+Before adding a new document, ensure that this document is distinct from any other document in the library, otherwise update an existing document.
 The document name should be one or two words in SCREAMING_SNAKECASE.
 
-You should extract a section from the sources file to create the document. Each document should contain high-value, actionable content that solves real implementation problems. Focus on:
+You should extract a section from the sources file to create the document. Each document should contain actionable technical content. Focus on:
 
 1. A normalised extract of the crawled content containing:
-   a. The most impactful key technical points that directly enable implementation, not summaries of them
-   b. A focused table of contents listing the specific technical topics that provide the greatest practical value
-   c. The actual detailed information for each item in the table of contents, prioritizing content that enables immediate application
-2. A supplementary details section containing the essential technical specifications and implementation details that complement the crawled content and address core functionality needs
+   a. The key technical points that directly enable implementation, not summaries of them
+   b. A focused table of contents listing the specific technical topics covered
+   c. The actual detailed information for each item in the table of contents
+2. A supplementary details section containing the technical specifications and implementation details that complement the crawled content
 3. A reference details section containing the critical API specifications, complete SDK method signatures with parameters
    and return types, exact implementation patterns, specific configuration options with their values
    and effects, concrete best practices with implementation examples, step-by-step troubleshooting procedures, and
-   detailed instructional material. Focus on specifications that deliver substantial user value. Do not describe what specifications exist, include the actual specifications themselves.
-4. A detailed digest containing the most valuable technical content from the source section in SOURCES.md and the date when the
+   detailed instructional material. Do not describe what specifications exist, include the actual specifications themselves.
+4. A detailed digest containing the technical content from the source section in SOURCES.md and the date when the
    content was retrieved (current date)
 5. Attribution information and data size obtained during crawling
 
@@ -24,8 +24,7 @@ Don't use any quote escape sequences in the normalised extract.
 Generally, the whole document might need to be extracted and stored as JSON so be careful to avoid any JSON escape
 sequences in any part of the document. Use spacing to make it readable and avoid complex Markdown formatting.
 
-For the normalised extract, extract the most valuable technical information from the crawled data and present it in a condensed,
-directly usable format that solves real implementation problems. Focus on high-impact content that enables immediate application.
-Do not describe what information exists, include the actual information itself. The content must be specific, technical,
-and immediately applicable to core functionality needs. Each item in the table of contents must have the essential
-technical details that thoroughly explain the implementation while prioritizing content that delivers substantial user value.
+For the normalised extract, extract the technical information from the crawled data and present it in a condensed,
+directly usable format.
+Do not describe what information exists, include the actual information itself. The content must be specific and technical.
+Each item in the table of contents must have the technical details that thoroughly explain the implementation.

package/src/agents/agent-ready-issue.md

@@ -1,13 +1,13 @@
-Please review the GitHub issue and determine if it should be enhanced, closed or if no operation is needed. Focus on issues that deliver substantial user value and address core functionality needs.
+Please review the GitHub issue and determine if it should be enhanced, closed or if no operation is needed.
 
-If the issue is relevant to the mission statement and features and provides significant value by enhancing the product's primary purpose:
+If the issue is relevant to the mission statement and features:
 
 1. Decide if the issue should be refined, closed or if no operation is needed.
-2. Update the issue description with testable acceptance criteria that validate the delivery of measurable user value
-3. Enhance the issue by adding relevant library documents as issue comments that support implementation of high-impact solutions
+2. Update the issue description with testable acceptance criteria derived from MISSION.md. Include ALL of: implementation, tests matching MISSION.md acceptance criteria, website updates, docs/evidence, and README. The issue should ask for mission complete — if the entire mission can be accomplished in a single transform, the acceptance criteria should cover everything. Only scope down if the mission is genuinely too large for one pass.
+3. Enhance the issue by adding relevant library documents as issue comments that support implementation.
 
-If the issue is irrelevant to the mission statement or features, or does not deliver substantial user value by addressing real problems:
+If the issue is irrelevant to the mission statement or features:
 
-1. Set the action to close the issue and supply an appropriate comment explaining why it doesn't align with the focus on high-impact, core functionality.
+1. Set the action to close the issue and supply an appropriate comment explaining why it doesn't advance the mission.
 
-Input validation issues that don't directly affect core functionality should be considered low value, and in particular, issues mentioning handling of NaN are probably worthless and should be closed. Prioritize issues that solve real problems rather than those focused on superficial improvements or excessive validation.
+Input validation issues that don't advance the mission should be closed, and in particular, issues mentioning handling of NaN are probably worthless and should be closed.

package/src/agents/agent-review-issue.md

@@ -1,5 +1,13 @@
-Does the combination source file, test file, README file and dependencies file show a solution
-with a reasonable likelihood of including a high-impact resolution to the following issue? Evaluate whether the solution delivers substantial user value, addresses core functionality needs, and directly enhances the product's primary purpose rather than implementing superficial improvements or excessive validation.
+Does the combination source file, test file, website files, README file and dependencies file resolve the following issue? Check that the solution satisfies the issue's acceptance criteria and moves the mission toward complete.
+
+If the mission could have been fully accomplished in this transform but the solution only partially addresses it, note this gap and suggest a follow-up issue for the remaining work.
+
+When reviewing, check that:
+- Tests and implementation are consistent — test expectations must match what the code actually returns (casing, types, formats)
+- Tests match the acceptance criteria in MISSION.md — the mission is the source of truth
+- If tests expect different values than the code produces, create an issue to fix the mismatch
+
+Note: The repository has a website in `src/web/` that uses the JS library. When reviewing, check that website files are updated alongside library changes.
 
 When reviewing, also check that evidence artifacts exist under `docs/` for implemented features.
 If a feature works but has no evidence (no example outputs, test results, or walkthroughs in `docs/`),

package/src/agents/agent-supervisor.md

@@ -2,7 +2,7 @@ You are the supervisor of an autonomous coding repository. Your job is to advanc
 
 ## Priority Order
 
-1. **Create issues when the backlog is low** — if fewer than 3 open issues exist, create at least 1 new issue from the features list or mission before dispatching workflows. The pipeline stalls without issues to work on. Always include descriptive titles and the `automated` label.
+1. **Always strive for mission complete** — every action you take should aim to finish the mission. Create one comprehensive issue that targets the entire mission (all acceptance criteria, tests, website, docs, README). Only create a second issue if the first transform couldn't complete everything, and scope it to the remaining work. Do not create issues just to fill a quota.
 2. **Dispatch transform when ready issues exist** — transform is where code gets written. Always prefer it over maintain when there are open issues with the `ready` label.
 3. **Dispatch review after transform** — when recent workflow runs show a transform completion, dispatch review to close resolved issues and add `ready` labels to new issues. This keeps the pipeline flowing.
 4. **Fix failing PRs** — dispatch fix-code for any PR with failing checks (include pr-number).
@@ -12,12 +12,12 @@ You are the supervisor of an autonomous coding repository. Your job is to advanc
 
 1. **Check what's already in progress** — don't duplicate work. If the workflow is already running, don't dispatch another.
 2. **Prioritise code generation** — the goal is working code. Prefer actions that produce code (dev-only, fix) over metadata (maintain, label).
-3. **Keep the issue pipeline full** — the biggest bottleneck is running out of open issues. Proactively create issues when capacity allows.
+3. **Right-size the work** — break the mission into chunks just big enough to reliably deliver. One comprehensive issue is better than many small ones. Only create a follow-up issue when the previous transform has landed and gaps remain.
 4. **Respect limits** — don't create issues beyond the WIP limit shown in the context. Don't dispatch workflows that will fail due to missing prerequisites.
 
 ## When to use each action
 
-- **github:create-issue** — When open issues < WIP limit. Derive the issue title from unimplemented features or mission goals. Always include relevant labels (`automated`, `enhancement`).
+- **github:create-issue** — When open issues < WIP limit. Create comprehensive issues that ask for maximum implementation in a single transform. Each issue should request: implementation code, matching tests, website updates, docs/evidence, and README changes. The first issue should aim to deliver the entire mission (all acceptance criteria, tests, website, docs). If a follow-up issue is needed, it should address whatever the first transform didn't complete. Always include relevant labels (`automated`, `enhancement`).
 - **dispatch:agentic-lib-workflow | mode: dev-only | issue-number: \<N\>** — When there are open issues with the `ready` label and no workflow is currently running.
 - **dispatch:agentic-lib-workflow | mode: review-only** — After observing a recent transform completion, or when there are unenhanced issues needing the `ready` label.
 - **dispatch:agentic-lib-workflow | mode: maintain-only** — When features are below their limit AND no maintain appears in the last 3 workflow runs.
@@ -38,7 +38,7 @@ When open issues with the `automated` label lack the `ready` label and are more
 ### Mission Initialised (init completed)
 When recent workflow runs show an init completion, the repository has a fresh or updated mission.
 Dispatch the discussions bot to announce the new mission to the community.
-Include the website URL in the announcement — the site is at `https://<owner>.github.io/<repo>/`.
+Include the website URL in the announcement — the site is at `https://<owner>.github.io/<repo>/` and runs the library.
 
 ### Mission Accomplished (bounded missions)
 When ALL of the following conditions are met, the mission is accomplished:
@@ -48,7 +48,7 @@ When ALL of the following conditions are met, the mission is accomplished:
 4. Evidence artifacts exist under `docs/` (example outputs, test results, or walkthroughs)
 
 When all conditions are met:
-1. `dispatch:agentic-lib-bot` — announce mission accomplished in the discussions thread. Include the website URL (`https://<owner>.github.io/<repo>/`) so users can see the finished product.
+1. `dispatch:agentic-lib-bot` — announce mission accomplished in the discussions thread. Include the website URL (`https://<owner>.github.io/<repo>/`) where users can see the finished product.
 2. `set-schedule:off` — stop the workflow. The mission is done.
 3. Log `mission-accomplished` in the activity log.
 

package/src/agents/agentic-lib.yml

@@ -25,6 +25,9 @@ paths:
   targetSourcePath:
     path: "src/lib/"
     permissions: ["write"]
+  targetWebPath:
+    path: "src/web/"
+    permissions: ["write"]
   dependenciesFilepath:
     path: "package.json"
     permissions: ["write"]

package/src/seeds/zero-index.html

@@ -4,21 +4,59 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>repository0</title>
+  <meta property="og:title" content="repository0">
+  <meta property="og:description" content="An autonomous repository powered by agentic-lib">
+  <meta property="og:type" content="website">
   <style>
     body { font-family: system-ui, -apple-system, sans-serif; max-width: 800px; margin: 0 auto; padding: 2rem; color: #333; }
     h1 { border-bottom: 2px solid #eee; padding-bottom: 0.5rem; }
     a { color: #0366d6; }
-    .status { background: #f6f8fa; padding: 1rem; border-radius: 6px; margin: 1rem 0; }
+    .identity { background: #f6f8fa; padding: 1rem; border-radius: 6px; margin: 1rem 0; font-family: monospace; }
+    .identity dt { font-weight: bold; color: #666; }
+    .identity dd { margin: 0 0 0.5rem 0; font-size: 1.1rem; }
+    .social { display: flex; gap: 1rem; margin: 1rem 0; flex-wrap: wrap; }
+    .social a { display: inline-block; padding: 0.4rem 0.8rem; border: 1px solid #ddd; border-radius: 4px; text-decoration: none; font-size: 0.9rem; }
+    .social a:hover { background: #f6f8fa; }
+    #demo-output { background: #1e1e1e; color: #d4d4d4; padding: 1rem; border-radius: 6px; font-family: monospace; white-space: pre-wrap; min-height: 2rem; }
   </style>
 </head>
 <body>
-  <h1>repository0</h1>
-  <div class="status">
-    <p>This website is maintained by the autonomous pipeline. It showcases the library built from the project's mission.</p>
+  <h1 id="lib-name">repository0</h1>
+  <div class="identity">
+    <dl>
+      <dt>Version</dt>
+      <dd id="lib-version">loading...</dd>
+      <dt>Description</dt>
+      <dd id="lib-description">loading...</dd>
+    </dl>
+  </div>
+  <h2>Output</h2>
+  <div id="demo-output">Loading library...</div>
+  <h2>Links</h2>
+  <div class="social">
+    <a id="share-github" href="https://github.com/xn-intenton-z2a/repository0" target="_blank" rel="noopener">GitHub</a>
+    <a id="share-twitter" href="#" target="_blank" rel="noopener">X/Twitter</a>
+    <a id="share-linkedin" href="#" target="_blank" rel="noopener">LinkedIn</a>
   </div>
   <h2>About</h2>
-  <p>See <a href="https://github.com/xn-intenton-z2a/repository0">the repository</a> for source code and mission details.</p>
-  <h2>Demo</h2>
-  <p><em>The pipeline will evolve this section to demonstrate the library's capabilities.</em></p>
+  <p>This website uses the library. See <a href="https://github.com/xn-intenton-z2a/repository0">the repository</a> for source code and mission details.</p>
+  <script type="module">
+    try {
+      const { name, version, description } = await import('./lib-meta.js');
+      document.getElementById('lib-name').textContent = name;
+      document.getElementById('lib-version').textContent = version;
+      document.getElementById('lib-description').textContent = description || '(no description)';
+      document.getElementById('demo-output').textContent = JSON.stringify({ name, version, description }, null, 2);
+      document.title = name + ' v' + version;
+      const pageUrl = encodeURIComponent(window.location.href);
+      const text = encodeURIComponent('Check out ' + name + ' v' + version + ' — ' + description);
+      document.getElementById('share-twitter').href = 'https://x.com/intent/tweet?url=' + pageUrl + '&text=' + text;
+      document.getElementById('share-linkedin').href = 'https://www.linkedin.com/sharing/share-offsite/?url=' + pageUrl;
+    } catch (e) {
+      document.getElementById('lib-version').textContent = '(build required)';
+      document.getElementById('lib-description').textContent = 'Run npm run build:web to generate library metadata';
+      document.getElementById('demo-output').textContent = 'Library not yet built. Run: npm run build:web';
+    }
+  </script>
 </body>
 </html>

package/src/seeds/zero-main.js

@@ -3,10 +3,30 @@
 // Copyright (C) 2025-2026 Polycode Limited
 // src/lib/main.js
 
+import { createRequire } from "module";
 import { fileURLToPath } from "url";
 
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+
+export const name = pkg.name;
+export const version = pkg.version;
+export const description = pkg.description;
+
+export function getIdentity() {
+  return { name, version, description };
+}
+
 export function main(args) {
-  console.log(`Run with: ${JSON.stringify(args)}`);
+  if (args?.includes("--version")) {
+    console.log(version);
+    return;
+  }
+  if (args?.includes("--identity")) {
+    console.log(JSON.stringify(getIdentity(), null, 2));
+    return;
+  }
+  console.log(`${name}@${version}`);
 }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) {

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

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (C) 2025-2026 Polycode Limited
-import { describe, test } from "vitest";
-import { main } from "../../src/lib/main.js";
+import { describe, test, expect } from "vitest";
+import { main, getIdentity, name, version, description } from "../../src/lib/main.js";
 
 describe("Main Output", () => {
   test("should terminate without error", () => {
@@ -9,3 +9,18 @@ describe("Main Output", () => {
     main();
   });
 });
+
+describe("Library Identity", () => {
+  test("exports name, version, and description", () => {
+    expect(typeof name).toBe("string");
+    expect(typeof version).toBe("string");
+    expect(typeof description).toBe("string");
+    expect(name.length).toBeGreaterThan(0);
+    expect(version).toMatch(/^\d+\.\d+\.\d+/);
+  });
+
+  test("getIdentity returns correct structure", () => {
+    const identity = getIdentity();
+    expect(identity).toEqual({ name, version, description });
+  });
+});

package/src/seeds/zero-package.json

@@ -6,17 +6,17 @@
   "main": "src/lib/main.js",
   "scripts": {
     "build": "npm run build:web",
-    "build:web": "mkdir -p docs && touch docs/.nojekyll && cp -r src/web/* docs/ 2>/dev/null || echo 'No web files to build'",
+    "build:web": "mkdir -p docs && touch docs/.nojekyll && cp -r src/web/* docs/ 2>/dev/null || true && node --input-type=commonjs -p \"var p=require('./package.json');['name','version','description'].map(function(k){return 'export const '+k+' = '+JSON.stringify(p[k])+';'}).join('\\n')\" > docs/lib-meta.js",
     "test": "vitest --run tests/unit/*.test.js",
     "test:unit": "vitest --run --coverage tests/unit/*.test.js",
-    "start": "node src/lib/main.js",
-    "start:web": "npx serve docs"
+    "start": "npm run build:web && npx serve docs",
+    "start:cli": "node src/lib/main.js"
   },
   "keywords": [],
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.67"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.69"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

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

@@ -14,4 +14,20 @@ describe("Website", () => {
     expect(html).toContain("<html");
     expect(html).toContain("</html>");
   });
+
+  test("index.html imports the library via lib-meta.js", () => {
+    const html = readFileSync("src/web/index.html", "utf8");
+    expect(html).toContain("lib-meta.js");
+  });
+
+  test("index.html displays library identity elements", () => {
+    const html = readFileSync("src/web/index.html", "utf8");
+    expect(html).toContain("lib-name");
+    expect(html).toContain("lib-version");
+  });
+
+  test("index.html has social share links", () => {
+    const html = readFileSync("src/web/index.html", "utf8");
+    expect(html).toMatch(/share.*(twitter|x\.com|linkedin)/is);
+  });
 });