@ias-ai/zhima-spec 1.3.6 → 1.3.9

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2024 ZhiMa Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-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.
-
+MIT License
+
+Copyright (c) 2024 ZhiMa Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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.
+

package/README.md

@@ -1,206 +1,206 @@
-<p align="center">
-  <a href="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow">
-    <picture>
-      <source srcset="assets/zhima_bg.png">
-      <img src="assets/zhima_bg.png" alt="ZhiMa logo">
-    </picture>
-  </a>
-</p>
-
-<p align="center">
-  <a href="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/actions/workflows/ci.yml"><img alt="CI" src="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/actions/workflows/ci.yml/badge.svg" /></a>
-  <a href="https://www.npmjs.com/package/@ias-ai/zhima-spec"><img alt="npm version" src="https://img.shields.io/npm/v/@ias-ai/zhima-spec?style=flat-square" /></a>
-  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
-  <a href="https://discord.gg/YctCnvvshC"><img alt="Discord" src="https://img.shields.io/discord/1411657095639601154?style=flat-square&logo=discord&logoColor=white&label=Discord&suffix=%20online" /></a>
-</p>
-
-<details>
-<summary><strong>The most loved spec framework.</strong></summary>
-
-[![Stars](https://img.shields.io/github/stars/zhima-agent/ias-workflow?style=flat-square&label=Stars)](https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/stargazers)
-[![Downloads](https://img.shields.io/npm/dm/@ias-ai/zhima-spec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@ias-ai/zhima-spec)
-[![Contributors](https://img.shields.io/github/contributors/zhima-agent/ias-workflow?style=flat-square&label=Contributors)](https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/graphs/contributors)
-
-</details>
-<p></p>
-Our philosophy:
-
-```text
-→ fluid not rigid
-→ iterative not waterfall
-→ easy not complex
-→ built for brownfield not just greenfield
-→ scalable from personal projects to enterprises
-```
-
-> [!TIP]
-> **New workflow now available!** We've rebuilt ZhiMa with a new artifact-guided workflow.
->
-> Run `/zm:propose "your idea"` to get started. → [Learn more here](docs/zm.md)
-
-<p align="center">
-  Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates · Join the <a href="https://discord.gg/YctCnvvshC">ZhiMa Discord</a> for help and questions.
-</p>
-
-<!-- TODO: Add GIF demo of /zm:propose → /zm:archive workflow -->
-
-## See it in action
-
-```text
-You: /zm:propose add-dark-mode
-AI:  Created zhima/changes/add-dark-mode/
-     ✓ proposal.md — why we're doing this, what's changing
-     ✓ specs/       — requirements and scenarios
-     ✓ design.md    — technical approach
-     ✓ tasks.md     — implementation checklist
-     Ready for implementation!
-
-You: /zm:apply
-AI:  Implementing tasks...
-     ✓ 1.1 Add theme context provider
-     ✓ 1.2 Create toggle component
-     ✓ 2.1 Add CSS variables
-     ✓ 2.2 Wire up localStorage
-     All tasks complete!
-
-You: /zm:archive
-AI:  Archived to zhima/changes/archive/2025-01-23-add-dark-mode/
-     Specs updated. Ready for the next feature.
-```
-
-<details>
-<summary><strong>ZhiMa Dashboard</strong></summary>
-
-<p align="center">
-  <img src="assets/zhima_dashboard.png" alt="ZhiMa dashboard preview" width="90%">
-</p>
-
-</details>
-
-## Quick Start
-
-**Requires Node.js 20.19.0 or higher.**
-
-Install ZhiMa globally:
-
-```bash
-npm install -g @ias-ai/zhima-spec@latest
-```
-
-Then navigate to your project directory and initialize:
-
-```bash
-cd your-project
-zhima init
-```
-
-Now tell your AI: `/zm:propose <what-you-want-to-build>`
-
-If you want the expanded workflow (`/zm:new`, `/zm:continue`, `/zm:ff`, `/zm:verify`, `/zm:bulk-archive`, `/zm:onboard`), select it with `zhima config profile` and apply with `zhima update`.
-
-> [!NOTE]
-> Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 25+ tools and growing.
->
-> Also works with pnpm, yarn, bun, and nix. [See installation options](docs/installation.md).
-
-## Docs
-
-→ **[Getting Started](docs/getting-started.md)**: first steps<br>
-→ **[Workflows](docs/workflows.md)**: combos and patterns<br>
-→ **[Commands](docs/commands.md)**: slash commands & skills<br>
-→ **[CLI](docs/cli.md)**: terminal reference<br>
-→ **[Supported Tools](docs/supported-tools.md)**: tool integrations & install paths<br>
-→ **[Concepts](docs/concepts.md)**: how it all fits<br>
-→ **[Multi-Language](docs/multi-language.md)**: multi-language support<br>
-→ **[Customization](docs/customization.md)**: make it yours
-
-
-## Community schemas
-
-Third-party schema bundles distributed via standalone repositories — these provide opinionated workflows that integrate ZhiMa with other tools, similar to how [github/spec-kit's community extension catalog](https://github.com/github/spec-kit/tree/main/extensions) handles tool integrations.
-
-→ **[Browse the catalog](docs/customization.md#community-schemas)** in the customization docs.
-
-
-## Why ZhiMa?
-
-AI coding assistants are powerful but unpredictable when requirements live only in chat history. ZhiMa adds a lightweight spec layer so you agree on what to build before any code is written.
-
-- **Agree before you build** — human and AI align on specs before code gets written
-- **Stay organized** — each change gets its own folder with proposal, specs, design, and tasks
-- **Work fluidly** — update any artifact anytime, no rigid phase gates
-- **Use your tools** — works with 20+ AI assistants via slash commands
-
-### How we compare
-
-**vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Thorough but heavyweight. Rigid phase gates, lots of Markdown, Python setup. ZhiMa is lighter and lets you iterate freely.
-
-**vs. [Kiro](https://kiro.dev)** (AWS) — Powerful but you're locked into their IDE and limited to Claude models. ZhiMa works with the tools you already use.
-
-**vs. nothing** — AI coding without specs means vague prompts and unpredictable results. ZhiMa brings predictability without the ceremony.
-
-## Updating ZhiMa
-
-**Upgrade the package**
-
-```bash
-npm install -g @ias-ai/zhima-spec@latest
-```
-
-**Refresh agent instructions**
-
-Run this inside each project to regenerate AI guidance and ensure the latest slash commands are active:
-
-```bash
-zhima update
-```
-
-## Usage Notes
-
-**Model selection**: ZhiMa works best with high-reasoning models. We recommend Codex 5.5 and Opus 4.7 for both planning and implementation.
-
-**Context hygiene**: ZhiMa benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.
-
-## Contributing
-
-**Small fixes** — Bug fixes, typo corrections, and minor improvements can be submitted directly as PRs.
-
-**Larger changes** — For new features, significant refactors, or architectural changes, please submit an ZhiMa change proposal first so we can align on intent and goals before implementation begins.
-
-When writing proposals, keep the ZhiMa philosophy in mind: we serve a wide variety of users across different coding agents, models, and use cases. Changes should work well for everyone.
-
-**AI-generated code is welcome** — as long as it's been tested and verified. PRs containing AI-generated code should mention the coding agent and model used (e.g., "Generated with Claude Code using claude-opus-4-5-20251101").
-
-### Development
-
-- Install dependencies: `pnpm install`
-- Build: `pnpm run build`
-- Test: `pnpm test`
-- Develop CLI locally: `pnpm run dev` or `pnpm run dev:cli`
-- Conventional commits (one-line): `type(scope): subject`
-
-## Other
-
-<details>
-<summary><strong>Telemetry</strong></summary>
-
-ZhiMa collects anonymous usage stats.
-
-We collect only command names and version to understand usage patterns. No arguments, paths, content, or PII. Automatically disabled in CI.
-
-**Opt-out:** `export OPENSPEC_TELEMETRY=0` or `export DO_NOT_TRACK=1`
-
-</details>
-
-<details>
-<summary><strong>Maintainers & Advisors</strong></summary>
-
-See [MAINTAINERS.md](MAINTAINERS.md) for the list of core maintainers and advisors who help guide the project.
-
-</details>
-
-
-
-## License
-
-MIT
+<p align="center">
+  <a href="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow">
+    <picture>
+      <source srcset="assets/zhima_bg.png">
+      <img src="assets/zhima_bg.png" alt="ZhiMa logo">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/actions/workflows/ci.yml"><img alt="CI" src="https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/actions/workflows/ci.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@ias-ai/zhima-spec"><img alt="npm version" src="https://img.shields.io/npm/v/@ias-ai/zhima-spec?style=flat-square" /></a>
+  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
+  <a href="https://discord.gg/YctCnvvshC"><img alt="Discord" src="https://img.shields.io/discord/1411657095639601154?style=flat-square&logo=discord&logoColor=white&label=Discord&suffix=%20online" /></a>
+</p>
+
+<details>
+<summary><strong>The most loved spec framework.</strong></summary>
+
+[![Stars](https://img.shields.io/github/stars/zhima-agent/ias-workflow?style=flat-square&label=Stars)](https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/stargazers)
+[![Downloads](https://img.shields.io/npm/dm/@ias-ai/zhima-spec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@ias-ai/zhima-spec)
+[![Contributors](https://img.shields.io/github/contributors/zhima-agent/ias-workflow?style=flat-square&label=Contributors)](https://gitlab.oneberry.cc:2083/zhima-agent/ias-workflow/graphs/contributors)
+
+</details>
+<p></p>
+Our philosophy:
+
+```text
+→ fluid not rigid
+→ iterative not waterfall
+→ easy not complex
+→ built for brownfield not just greenfield
+→ scalable from personal projects to enterprises
+```
+
+> [!TIP]
+> **New workflow now available!** We've rebuilt ZhiMa with a new artifact-guided workflow.
+>
+> Run `/zm:propose "your idea"` to get started. → [Learn more here](docs/zm.md)
+
+<p align="center">
+  Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates · Join the <a href="https://discord.gg/YctCnvvshC">ZhiMa Discord</a> for help and questions.
+</p>
+
+<!-- TODO: Add GIF demo of /zm:propose → /zm:archive workflow -->
+
+## See it in action
+
+```text
+You: /zm:propose add-dark-mode
+AI:  Created zhima/changes/add-dark-mode/
+     ✓ proposal.md — why we're doing this, what's changing
+     ✓ specs/       — requirements and scenarios
+     ✓ design.md    — technical approach
+     ✓ tasks.md     — implementation checklist
+     Ready for implementation!
+
+You: /zm:apply
+AI:  Implementing tasks...
+     ✓ 1.1 Add theme context provider
+     ✓ 1.2 Create toggle component
+     ✓ 2.1 Add CSS variables
+     ✓ 2.2 Wire up localStorage
+     All tasks complete!
+
+You: /zm:archive
+AI:  Archived to zhima/changes/archive/2025-01-23-add-dark-mode/
+     Specs updated. Ready for the next feature.
+```
+
+<details>
+<summary><strong>ZhiMa Dashboard</strong></summary>
+
+<p align="center">
+  <img src="assets/zhima_dashboard.png" alt="ZhiMa dashboard preview" width="90%">
+</p>
+
+</details>
+
+## Quick Start
+
+**Requires Node.js 20.19.0 or higher.**
+
+Install ZhiMa globally:
+
+```bash
+npm install -g @ias-ai/zhima-spec@latest
+```
+
+Then navigate to your project directory and initialize:
+
+```bash
+cd your-project
+zhima init
+```
+
+Now tell your AI: `/zm:propose <what-you-want-to-build>`
+
+If you want the expanded workflow (`/zm:new`, `/zm:continue`, `/zm:ff`, `/zm:verify`, `/zm:bulk-archive`, `/zm:onboard`), select it with `zhima config profile` and apply with `zhima update`.
+
+> [!NOTE]
+> Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 25+ tools and growing.
+>
+> Also works with pnpm, yarn, bun, and nix. [See installation options](docs/installation.md).
+
+## Docs
+
+→ **[Getting Started](docs/getting-started.md)**: first steps<br>
+→ **[Workflows](docs/workflows.md)**: combos and patterns<br>
+→ **[Commands](docs/commands.md)**: slash commands & skills<br>
+→ **[CLI](docs/cli.md)**: terminal reference<br>
+→ **[Supported Tools](docs/supported-tools.md)**: tool integrations & install paths<br>
+→ **[Concepts](docs/concepts.md)**: how it all fits<br>
+→ **[Multi-Language](docs/multi-language.md)**: multi-language support<br>
+→ **[Customization](docs/customization.md)**: make it yours
+
+
+## Community schemas
+
+Third-party schema bundles distributed via standalone repositories — these provide opinionated workflows that integrate ZhiMa with other tools, similar to how [github/spec-kit's community extension catalog](https://github.com/github/spec-kit/tree/main/extensions) handles tool integrations.
+
+→ **[Browse the catalog](docs/customization.md#community-schemas)** in the customization docs.
+
+
+## Why ZhiMa?
+
+AI coding assistants are powerful but unpredictable when requirements live only in chat history. ZhiMa adds a lightweight spec layer so you agree on what to build before any code is written.
+
+- **Agree before you build** — human and AI align on specs before code gets written
+- **Stay organized** — each change gets its own folder with proposal, specs, design, and tasks
+- **Work fluidly** — update any artifact anytime, no rigid phase gates
+- **Use your tools** — works with 20+ AI assistants via slash commands
+
+### How we compare
+
+**vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Thorough but heavyweight. Rigid phase gates, lots of Markdown, Python setup. ZhiMa is lighter and lets you iterate freely.
+
+**vs. [Kiro](https://kiro.dev)** (AWS) — Powerful but you're locked into their IDE and limited to Claude models. ZhiMa works with the tools you already use.
+
+**vs. nothing** — AI coding without specs means vague prompts and unpredictable results. ZhiMa brings predictability without the ceremony.
+
+## Updating ZhiMa
+
+**Upgrade the package**
+
+```bash
+npm install -g @ias-ai/zhima-spec@latest
+```
+
+**Refresh agent instructions**
+
+Run this inside each project to regenerate AI guidance and ensure the latest slash commands are active:
+
+```bash
+zhima update
+```
+
+## Usage Notes
+
+**Model selection**: ZhiMa works best with high-reasoning models. We recommend Codex 5.5 and Opus 4.7 for both planning and implementation.
+
+**Context hygiene**: ZhiMa benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.
+
+## Contributing
+
+**Small fixes** — Bug fixes, typo corrections, and minor improvements can be submitted directly as PRs.
+
+**Larger changes** — For new features, significant refactors, or architectural changes, please submit an ZhiMa change proposal first so we can align on intent and goals before implementation begins.
+
+When writing proposals, keep the ZhiMa philosophy in mind: we serve a wide variety of users across different coding agents, models, and use cases. Changes should work well for everyone.
+
+**AI-generated code is welcome** — as long as it's been tested and verified. PRs containing AI-generated code should mention the coding agent and model used (e.g., "Generated with Claude Code using claude-opus-4-5-20251101").
+
+### Development
+
+- Install dependencies: `pnpm install`
+- Build: `pnpm run build`
+- Test: `pnpm test`
+- Develop CLI locally: `pnpm run dev` or `pnpm run dev:cli`
+- Conventional commits (one-line): `type(scope): subject`
+
+## Other
+
+<details>
+<summary><strong>Telemetry</strong></summary>
+
+ZhiMa collects anonymous usage stats.
+
+We collect only command names and version to understand usage patterns. No arguments, paths, content, or PII. Automatically disabled in CI.
+
+**Opt-out:** `export OPENSPEC_TELEMETRY=0` or `export DO_NOT_TRACK=1`
+
+</details>
+
+<details>
+<summary><strong>Maintainers & Advisors</strong></summary>
+
+See [MAINTAINERS.md](MAINTAINERS.md) for the list of core maintainers and advisors who help guide the project.
+
+</details>
+
+
+
+## License
+
+MIT

package/bin/zhima.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-
+
 import '../dist/cli/index.js';

package/dist/commands/feedback.js

@@ -59,10 +59,10 @@ function generateMetadata() {
     const version = getVersion();
     const platform = getPlatform();
     const timestamp = getTimestamp();
-    return `---
-Submitted via ZhiMa CLI
-- Version: ${version}
-- Platform: ${platform}
+    return `---
+Submitted via ZhiMa CLI
+- Version: ${version}
+- Platform: ${platform}
 - Timestamp: ${timestamp}`;
 }
 /**

package/dist/commands/schema.js

@@ -795,74 +795,74 @@ export function registerSchemaCommand(program) {
 function createDefaultTemplate(artifactId) {
     switch (artifactId) {
         case 'proposal':
-            return `## Why
-
-<!-- Describe the motivation for this change -->
-
-## What Changes
-
-<!-- Describe what will change -->
-
-## Capabilities
-
-### New Capabilities
-<!-- List new capabilities -->
-
-### Modified Capabilities
-<!-- List modified capabilities -->
-
-## Impact
-
-<!-- Describe the impact on existing functionality -->
+            return `## Why
+
+<!-- Describe the motivation for this change -->
+
+## What Changes
+
+<!-- Describe what will change -->
+
+## Capabilities
+
+### New Capabilities
+<!-- List new capabilities -->
+
+### Modified Capabilities
+<!-- List modified capabilities -->
+
+## Impact
+
+<!-- Describe the impact on existing functionality -->
 `;
         case 'specs':
-            return `## ADDED Requirements
-
-### Requirement: Example requirement
-
-Description of the requirement.
-
-#### Scenario: Example scenario
-- **WHEN** some condition
-- **THEN** some outcome
+            return `## ADDED Requirements
+
+### Requirement: Example requirement
+
+Description of the requirement.
+
+#### Scenario: Example scenario
+- **WHEN** some condition
+- **THEN** some outcome
 `;
         case 'design':
-            return `## Context
-
-<!-- Background and context -->
-
-## Goals / Non-Goals
-
-**Goals:**
-<!-- List goals -->
-
-**Non-Goals:**
-<!-- List non-goals -->
-
-## Decisions
-
-### 1. Decision Name
-
-Description and rationale.
-
-**Alternatives considered:**
-- Alternative 1: Rejected because...
-
-## Risks / Trade-offs
-
-<!-- List risks and trade-offs -->
+            return `## Context
+
+<!-- Background and context -->
+
+## Goals / Non-Goals
+
+**Goals:**
+<!-- List goals -->
+
+**Non-Goals:**
+<!-- List non-goals -->
+
+## Decisions
+
+### 1. Decision Name
+
+Description and rationale.
+
+**Alternatives considered:**
+- Alternative 1: Rejected because...
+
+## Risks / Trade-offs
+
+<!-- List risks and trade-offs -->
 `;
         case 'tasks':
-            return `## Implementation Tasks
-
-- [ ] Task 1
-- [ ] Task 2
-- [ ] Task 3
+            return `## Implementation Tasks
+
+- [ ] Task 1
+- [ ] Task 2
+- [ ] Task 3
 `;
         default:
-            return `## ${artifactId}
-
-<!-- Add content here -->
+            return `## ${artifactId}
+
+<!-- Add content here -->
 `;
     }
 }

package/dist/core/command-generation/adapters/amazon-q.js

@@ -15,11 +15,11 @@ export const amazonQAdapter = {
         return path.join('.amazonq', 'prompts', `zm-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
----
-
-${content.body}
+        return `---
+description: ${content.description}
+---
+
+${content.body}
 `;
     },
 };

package/dist/core/command-generation/adapters/antigravity.js

@@ -15,11 +15,11 @@ export const antigravityAdapter = {
         return path.join('.agent', 'workflows', `zm-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
----
-
-${content.body}
+        return `---
+description: ${content.description}
+---
+
+${content.body}
 `;
     },
 };