heraspec 0.1.14 → 0.1.15

package/LICENSE

@@ -20,3 +20,190 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+
+---
+
+## Third-Party Components and Licenses
+
+This project includes components adapted from third-party sources. Specifically:
+
+* **Anthropic Knowledge Work Plugins**: The templates for several developer, SEO, marketing, system design, and product lifecycle skills under `src/core/templates/skills/` are adapted from the [anthropics/knowledge-work-plugins](https://github.com/anthropics/knowledge-work-plugins) repository.
+  - License: Apache License 2.0
+  - Copyright 2024 Anthropic PBC
+
+A copy of the Apache License 2.0 is included below:
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by interface) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if distributed along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.

package/README.md

@@ -44,69 +44,102 @@ HeraSpec is a specification-based development framework that helps you:
 >
 > Good luck, and build with love.
 
+## Showcase
+
+Here are some products built partially or entirely using the HeraSpec framework:
+
+<ul>
+    <li><a href="https://codecanyon.net/item/flexinote-for-perfex-crm/60590690" target="_blank">FlexNote for Perfex CRM</a> - Advanced note management with AI capabilities.</li>
+    <li><a href="https://codecanyon.net/item/polyutilities-for-perfex-crm-quick-access-menu-custom-js-css-and-more/49522529" target="_blank">PolyUtilities for Perfex CRM</a> - Essential toolkit for Perfex CRM customization.</li>
+    <li><a href="https://codecanyon.net/item/data-builder-for-perfex-crm/62297963" target="_blank">Data Builder — Visual Reporting, REST API & GraphQL for Perfex CRM</a> - Automated demo instance creator.</li>
+    <li><a href="https://chromewebstore.google.com/detail/flexinote/oendkbllnfafakogepolfaonionlkehc" target="_blank">FlexNote - Sticky Notes for Web</a> - Create, manage, and customize notes directly on any webpage.<br>
+    GitHub: <a href="https://github.com/PolyXGO/FlexiNote-extension" target="_blank">FlexNote - Smart Sticky Notes</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/polymetrics" target="_blank">PolyMetrics</a> - Product price analysis extension for Envato.</li>
+    <li><a href="https://erp.polyxgo.com/code/project/polydemo" target="_blank">PolyDemo</a> - Dynamic demonstration environment for web applications.</li>
+    <li><a href="https://erp.polyxgo.com/code/project/smart-payment-for-perfex-crm" target="_blank">Smart Payment for Perfex CRM</a> - Intelligent payment gateway integration.</li>
+    <li><a href="https://polycms.org" target="_blank">PolyCMS.org</a> - Open Source CMS based on Laravel, inspired by WordPress CMS.</li>
+    <li><a href="https://codecanyon.net/item/polycms-cms-website-builder-module-for-perfex-crm/63404011" target="_blank">PolyCMS – CMS & Website Builder Module for Perfex CRM</a> - A CMS system inspired by WordPress integrated into the open-source Perfex CRM.</li>
+    <li><a href="https://codecanyon.net/item/woosync-woocommerce-orders-customers-invoices-sync-for-perfex-crm/63032352" target="_blank">WooCommerce Sync for Perfex CRM</a> - A module for syncing products, customers, orders, and data between Perfex CRM and WooCommerce stores.</li>
+    <li><a href="https://headrandom.com" target="_blank">HeadRandom.com</a> - Products and content on this platform are managed with the support of HeraSpec.</li>
+</ul>
+
+### Plugin WordPress cho Phong Thủy Huyền Học
+
+<ul>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-geofesh" target="_blank">Xem Ngày Tốt Xấu</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-geofesh" target="_blank">Xem và Lập Lá Số Tứ Trụ - Bát Tự</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-sow-hexagram" target="_blank">Giao Quẻ Kinh Dịch - Lục Hào - Mai Hoa Tiên Thiên</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-geo-compass" target="_blank">Thước Lập Cực</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-palm-reading" target="_blank">Xem Chỉ Tay</a></li>
+    <li><a href="https://erp.polyxgo.com/code/project/pxg-face-reading" target="_blank">Diện Tướng</a></li>
+</ul>
+
+### Plugin WordPress khác
+
+<ul>
+    <li><a href="https://wordpress.org/plugins/white-label-builder/" target="_blank">White Label Builder</a></li>
+    <li><a href="https://wordpress.org/plugins/poly-support/" target="_blank">Poly Support</a></li>
+    <li><a href="https://wordpress.org/plugins/team-manager-unified/" target="_blank">Team Manager Unified</a></li>
+</ul>
+
 <!-- HeraSpec Section -->
+## HeraSpec Development
+
+This project uses [HeraSpec](https://github.com/PolyXGO/HeraSpec) for spec-driven development. For more information, see the [HeraSpec documentation](./docs/en/USER_GUIDE.md).
+
+### Quick Start
+
+```bash
+# Initialize HeraSpec (if not already done)
+heraspec init
+
+# List active changes
+heraspec list
+
+# View a change
+heraspec show <change-name>
+
+# Validate changes
+heraspec validate <change-name>
+```
+
+### Project Structure
+
+- `heraspec/project.md` - Project overview and configuration
+- `heraspec/specs/` - Source of truth specifications
+- `heraspec/changes/` - Active changes in progress
+- `heraspec/skills/` - Reusable skills for AI agents
+- `AGENTS.heraspec.md` - AI agent instructions
+
+### Working with Changes
+
+1. **Create a change**: Ask AI to create a HeraSpec change, or create manually
+2. **Refine specs**: Review and update delta specs in `heraspec/specs/<change-name>/`
+3. **Implement**: Follow tasks in `heraspec/changes/<change-name>/tasks.md`
+4. **Archive**: Run `heraspec archive <change-name> --yes` when complete
+
+### Skills
+
+Add skills to your project:
+
+```bash
+# List available skills
+heraspec skill list
+
+# Add a skill
+heraspec skill add ui-ux
+heraspec skill add unit-test
+
+# View skill details
+heraspec skill show ui-ux
+```
+
+For more information, see the [HeraSpec documentation](https://github.com/your-org/heraspec/docs).
+
+---
+
+*This section is automatically updated by `heraspec init`. Last updated: 2026-05-21*
 
-<!-- HeraSpec Section -->
-
-<!-- HeraSpec Section -->
-## HeraSpec Development
-
-This project uses [HeraSpec](https://github.com/your-org/heraspec) for spec-driven development.
-
-### Quick Start
-
-```bash
-# Initialize HeraSpec (if not already done)
-heraspec init
-
-# List active changes
-heraspec list
-
-# View a change
-heraspec show <change-name>
-
-# Validate changes
-heraspec validate <change-name>
-```
-
-### Project Structure
-
-- `heraspec/project.md` - Project overview and configuration
-- `heraspec/specs/` - Source of truth specifications
-- `heraspec/changes/` - Active changes in progress
-- `heraspec/skills/` - Reusable skills for AI agents
-- `AGENTS.heraspec.md` - AI agent instructions
-
-### Working with Changes
-
-1. **Create a change**: Ask AI to create a HeraSpec change, or create manually
-2. **Refine specs**: Review and update delta specs in `heraspec/specs/<change-name>/`
-3. **Implement**: Follow tasks in `heraspec/changes/<change-name>/tasks.md`
-4. **Archive**: Run `heraspec archive <change-name> --yes` when complete
-
-### Skills
-
-Add skills to your project:
-
-```bash
-# List available skills
-heraspec skill list
-
-# Add a skill
-heraspec skill add ui-ux
-heraspec skill add unit-test
-
-# View skill details
-heraspec skill show ui-ux
-```
-
-For more information, see the [HeraSpec documentation](https://github.com/your-org/heraspec/docs).
-
----
-
-*This section is automatically updated by `heraspec init`. Last updated: 2026-05-21*
-
-
 ## Installation
 
 ```bash
@@ -153,40 +186,6 @@ Integrate with AI tools for better development workflow: Cursor, Antigravity, Wi
 - **Copilot** - Enhanced development with structured specs
 - **Claude Desktop** - MCP-ready architecture for AI assistance
 
-## Showcase
-
-Here are some products built partially or entirely using the HeraSpec framework:
-
-<ul>
-    <li><a href="https://codecanyon.net/item/flexinote-for-perfex-crm/60590690" target="_blank">FlexNote for Perfex CRM</a> - Advanced note management with AI capabilities.</li>
-    <li><a href="https://codecanyon.net/item/polyutilities-for-perfex-crm-quick-access-menu-custom-js-css-and-more/49522529" target="_blank">PolyUtilities for Perfex CRM</a> - Essential toolkit for Perfex CRM customization.</li>
-    <li><a href="https://erp.polyxgo.com/code/project/demo-builder-for-perfex-crm" target="_blank">Demo Builder for Perfex CRM</a> - Automated demo instance creator.</li>
-    <li><a href="https://chromewebstore.google.com/detail/flexinote/oendkbllnfafakogepolfaonionlkehc" target="_blank">FlexNote - Sticky Notes for Web</a> - Create, manage, and customize notes directly on any webpage.<br>
-    GitHub: <a href="https://github.com/PolyXGO/FlexiNote-extension" target="_blank">FlexNote - Smart Sticky Notes</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/polymetrics" target="_blank">PolyMetrics</a> - Product price analysis extension for Envato.</li>
-    <li><a href="https://erp.polyxgo.com/code/project/polydemo" target="_blank">PolyDemo</a> - Dynamic demonstration environment for web applications.</li>
-    <li><a href="https://erp.polyxgo.com/code/project/smart-payment-for-perfex-crm" target="_blank">Smart Payment for Perfex CRM</a> - Intelligent payment gateway integration.</li>
-</ul>
-
-### Plugin WordPress cho Phong Thủy Huyền Học
-
-<ul>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-geofesh" target="_blank">Xem Ngày Tốt Xấu</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-geofesh" target="_blank">Xem và Lập Lá Số Tứ Trụ - Bát Tự</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-sow-hexagram" target="_blank">Giao Quẻ Kinh Dịch - Lục Hào - Mai Hoa Tiên Thiên</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-geo-compass" target="_blank">Thước Lập Cực</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-palm-reading" target="_blank">Xem Chỉ Tay</a></li>
-    <li><a href="https://erp.polyxgo.com/code/project/pxg-face-reading" target="_blank">Diện Tướng</a></li>
-</ul>
-
-### Plugin WordPress khác
-
-<ul>
-    <li><a href="https://wordpress.org/plugins/white-label-builder/" target="_blank">White Label Builder</a></li>
-    <li><a href="https://wordpress.org/plugins/poly-support/" target="_blank">Poly Support</a></li>
-    <li><a href="https://wordpress.org/plugins/team-manager-unified/" target="_blank">Team Manager Unified</a></li>
-</ul>
-
 ## Support
 
 <div align="center">