@harness-forge/cli 0.1.0

package/rules/powershell/testing.md

@@ -0,0 +1,24 @@
+---
+paths:
+  - "**/*.ps1"
+  - "**/*.psm1"
+extends: ../common/testing.md
+language: powershell
+layer: language
+---
+# PowerShell Testing
+
+> This file extends [common/testing.md](../common/testing.md) with PowerShell-specific testing guidance.
+
+## Defaults
+
+- Use Pester for tests.
+- Test parameter validation, object output shape, error behavior, and idempotent automation flows.
+- Mock external commands and remoting boundaries carefully.
+
+## Coverage priorities
+
+- bootstrap scripts
+- install/repair/uninstall paths
+- admin automation with safety switches
+- module public command behavior

package/rules/python/README.md

@@ -0,0 +1,19 @@
+# Python rules
+
+## Apply Order
+
+1. start with `rules/common/`
+2. layer `rules/python/` on top for language-specific implementation choices
+3. consult the structured docs and examples before deviating from the promoted patterns
+
+## Focus Areas
+
+- typing, packaging, and module boundaries
+- testing, validation, and dependency management
+- framework overlays such as FastAPI and Django when relevant
+
+## Related Pack Assets
+
+- `knowledge-bases/structured/python/docs/`
+- `knowledge-bases/structured/python/examples/`
+- `skills/python-engineering/SKILL.md`

package/rules/python/coding-style.md

@@ -0,0 +1,3 @@
+# Python coding style
+
+Favor readable, explicit code and consistent error handling.

package/rules/python/patterns.md

@@ -0,0 +1,3 @@
+# Python patterns
+
+Prefer well-known project layouts, dependency boundaries, and testable seams.

package/rules/python/security.md

@@ -0,0 +1,3 @@
+# Python security
+
+Validate untrusted input, avoid secret leakage, and prefer safe default execution paths.

package/rules/python/testing.md

@@ -0,0 +1,3 @@
+# Python testing
+
+Keep a fast default test command and cover critical behavior before refactors.

package/rules/python/tooling.md

@@ -0,0 +1,3 @@
+# Python tooling
+
+Document the expected formatter, linter, build command, and test command.

package/rules/rust/README.md

@@ -0,0 +1,19 @@
+# Rust rules
+
+## Apply Order
+
+1. start with `rules/common/`
+2. layer `rules/rust/` on top for ownership, error handling, and crate structure
+3. consult the structured docs and examples before deviating from the promoted patterns
+
+## Focus Areas
+
+- ownership and lifetime-safe design
+- error handling, testing, and trait boundaries
+- performance or unsafe concerns when relevant
+
+## Related Pack Assets
+
+- `knowledge-bases/structured/rust/docs/`
+- `knowledge-bases/structured/rust/examples/`
+- `skills/rust-engineering/SKILL.md`

package/rules/rust/coding-style.md

@@ -0,0 +1,3 @@
+# Rust coding style
+
+Favor readable, explicit code and consistent error handling.

package/rules/rust/patterns.md

@@ -0,0 +1,3 @@
+# Rust patterns
+
+Prefer well-known project layouts, dependency boundaries, and testable seams.

package/rules/rust/security.md

@@ -0,0 +1,3 @@
+# Rust security
+
+Validate untrusted input, avoid secret leakage, and prefer safe default execution paths.

package/rules/rust/testing.md

@@ -0,0 +1,3 @@
+# Rust testing
+
+Keep a fast default test command and cover critical behavior before refactors.

package/rules/rust/tooling.md

@@ -0,0 +1,3 @@
+# Rust tooling
+
+Document the expected formatter, linter, build command, and test command.

package/rules/shell/README.md

@@ -0,0 +1,19 @@
+# Shell rules
+
+## Apply Order
+
+1. start with `rules/common/`
+2. layer `rules/shell/` on top for quoting, portability, and operational safety
+3. consult the structured docs and examples before deviating from the promoted patterns
+
+## Focus Areas
+
+- portability and execution context
+- validation, logging, and failure handling
+- destructive-operation safety and operator ergonomics
+
+## Related Pack Assets
+
+- `knowledge-bases/structured/shell/docs/`
+- `knowledge-bases/structured/shell/examples/`
+- `skills/shell-engineering/SKILL.md`

package/rules/shell/coding-style.md

@@ -0,0 +1,3 @@
+# Shell coding style
+
+Favor readable, explicit code and consistent error handling.

package/rules/shell/patterns.md

@@ -0,0 +1,3 @@
+# Shell patterns
+
+Prefer well-known project layouts, dependency boundaries, and testable seams.

package/rules/shell/security.md

@@ -0,0 +1,3 @@
+# Shell security
+
+Validate untrusted input, avoid secret leakage, and prefer safe default execution paths.

package/rules/shell/testing.md

@@ -0,0 +1,3 @@
+# Shell testing
+
+Keep a fast default test command and cover critical behavior before refactors.

package/rules/shell/tooling.md

@@ -0,0 +1,3 @@
+# Shell tooling
+
+Document the expected formatter, linter, build command, and test command.

package/rules/swift/README.md

@@ -0,0 +1,19 @@
+# Swift rules
+
+## Apply Order
+
+1. start with `rules/common/`
+2. layer `rules/swift/` on top for package, API, and concurrency choices
+3. consult the structured docs and examples before deviating from the promoted patterns
+
+## Focus Areas
+
+- module boundaries and build organization
+- testing, concurrency, and API design
+- platform-specific behavior when relevant
+
+## Related Pack Assets
+
+- `knowledge-bases/structured/swift/docs/`
+- `knowledge-bases/structured/swift/examples/`
+- `skills/swift-engineering/SKILL.md`

package/rules/swift/coding-style.md

@@ -0,0 +1,3 @@
+# Swift coding style
+
+Favor readable, explicit code and consistent error handling.

package/rules/swift/patterns.md

@@ -0,0 +1,3 @@
+# Swift patterns
+
+Prefer well-known project layouts, dependency boundaries, and testable seams.

package/rules/swift/security.md

@@ -0,0 +1,3 @@
+# Swift security
+
+Validate untrusted input, avoid secret leakage, and prefer safe default execution paths.

package/rules/swift/testing.md

@@ -0,0 +1,3 @@
+# Swift testing
+
+Keep a fast default test command and cover critical behavior before refactors.

package/rules/swift/tooling.md

@@ -0,0 +1,3 @@
+# Swift tooling
+
+Document the expected formatter, linter, build command, and test command.

package/rules/typescript/README.md

@@ -0,0 +1,41 @@
+---
+id: rules-typescript
+kind: rule
+title: TypeScript Rules
+summary: Entry point for the seeded TypeScript baseline and language-specific rule set.
+status: stable
+owner: core
+applies_to:
+  - codex
+  - claude-code
+  - cursor
+  - opencode
+languages:
+  - typescript
+generated: false
+---
+# TypeScript Rules
+
+## Promoted baseline guidance
+
+- `rules/common/coding-style.md`
+- `rules/common/patterns.md`
+- `rules/common/testing.md`
+- `rules/common/security.md`
+- `rules/common/hooks.md`
+
+## Promoted language-specific guidance
+
+- `rules/typescript/coding-style.md`
+- `rules/typescript/patterns.md`
+- `rules/typescript/testing.md`
+- `rules/typescript/security.md`
+- `rules/typescript/hooks.md`
+
+## Canonical seed source
+
+- `knowledge-bases/seeded/typescript/rules/typescript/coding-style.md`
+- `knowledge-bases/seeded/typescript/rules/typescript/patterns.md`
+- `knowledge-bases/seeded/typescript/rules/typescript/testing.md`
+- `knowledge-bases/seeded/typescript/rules/typescript/security.md`
+- `knowledge-bases/seeded/typescript/rules/typescript/hooks.md`

package/rules/typescript/coding-style.md

@@ -0,0 +1,30 @@
+---
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/*.mts"
+  - "**/*.cts"
+extends: ../common/coding-style.md
+language: typescript
+layer: language
+---
+# TypeScript Coding Style
+
+> This file extends [common/coding-style.md](../common/coding-style.md) with TypeScript-specific guidance.
+
+## Types first
+
+- Exported functions and shared modules SHOULD expose explicit types.
+- Avoid `any`; use `unknown` and narrow safely.
+- Use `interface` for extensible object shapes and `type` for unions and mapped types.
+
+## Runtime truth
+
+- Static types are not runtime validation.
+- Validate all untrusted input at boundaries with schemas.
+
+## Project defaults
+
+- Prefer strict compiler options.
+- Keep browser-only and server-only code clearly separated.
+- Prefer pure functions and immutable updates where practical.

package/rules/typescript/hooks.md

@@ -0,0 +1,25 @@
+---
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "package.json"
+extends: ../common/hooks.md
+language: typescript
+layer: language
+---
+# TypeScript Hooks
+
+> This file extends [common/hooks.md](../common/hooks.md) with TypeScript-specific hook suggestions.
+
+## Post-edit hooks
+
+- formatter (Prettier or project formatter)
+- eslint on affected files
+- `tsc --noEmit` or project typecheck
+- affected unit tests when behavior changes
+
+## Stop hooks
+
+- final typecheck
+- warn on `console.log` in production paths
+- dependency audit when lockfiles change

package/rules/typescript/patterns.md

@@ -0,0 +1,23 @@
+---
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
+extends: ../common/patterns.md
+language: typescript
+layer: language
+---
+# TypeScript Patterns
+
+> This file extends [common/patterns.md](../common/patterns.md) with TypeScript-specific patterns.
+
+## Recommended patterns
+
+- schema-driven API/input validation
+- typed repository or service boundaries
+- explicit DTO mapping between transport and domain
+- shared packages for contracts only when versioning and ownership are clear
+
+## Frontend note
+
+- Keep server-fetching logic, UI state, and domain formatting concerns separated.
+- Use custom hooks for reuse, not for hiding unrelated logic.

package/rules/typescript/security.md

@@ -0,0 +1,23 @@
+---
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
+extends: ../common/security.md
+language: typescript
+layer: language
+---
+# TypeScript Security
+
+> This file extends [common/security.md](../common/security.md) with TypeScript-specific security guidance.
+
+## Node and web defaults
+
+- Never trust request bodies, query strings, cookies, headers, or local storage values.
+- Use env validation at startup.
+- Sanitize or escape untrusted HTML.
+- Treat SSR/server actions as privileged code paths.
+
+## Secrets
+
+- No hardcoded secrets.
+- Redact tokens and credentials from logs, traces, and test snapshots.

package/rules/typescript/testing.md

@@ -0,0 +1,22 @@
+---
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
+extends: ../common/testing.md
+language: typescript
+layer: language
+---
+# TypeScript Testing
+
+> This file extends [common/testing.md](../common/testing.md) with TypeScript-specific testing guidance.
+
+## Defaults
+
+- Prefer Vitest or Jest for unit/integration tests depending on project standards.
+- Use Playwright for user-facing end-to-end flows.
+- Test runtime validation, auth, error translation, and serialization explicitly.
+
+## Monorepo note
+
+- Run affected tests when available.
+- Guard shared package changes with focused integration coverage.

package/schemas/content/content-metadata.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/content/content-metadata.schema.json",
+  "title": "Harness Forge Content Metadata",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "id",
+    "kind",
+    "title",
+    "summary",
+    "status",
+    "owner",
+    "applies_to",
+    "languages",
+    "generated"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "kind": {
+      "type": "string",
+      "enum": [
+        "command",
+        "agent",
+        "context",
+        "rule",
+        "example",
+        "language-pack",
+        "style-guide",
+        "task-template",
+        "workflow-template"
+      ]
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "stable", "deprecated"]
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "applies_to": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "languages": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "generated": {
+      "type": "boolean"
+    },
+    "canonical_source": {
+      "type": "string",
+      "minLength": 1
+    },
+    "maturity": {
+      "type": "string",
+      "enum": ["seeded", "stable", "expanding"]
+    },
+    "targets": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "generated": {
+            "const": true
+          }
+        }
+      },
+      "then": {
+        "required": ["canonical_source"]
+      }
+    }
+  ]
+}

package/schemas/hooks/hook.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/hooks/hook.schema.json",
+  "title": "Harness Forge Hook Manifest",
+  "type": "object",
+  "required": [
+    "id",
+    "family",
+    "triggerStage",
+    "executionOrder",
+    "mode",
+    "timeoutBudget",
+    "retryPolicy",
+    "failurePolicy",
+    "requiredInputs",
+    "expectedOutputs",
+    "observabilityFields",
+    "targetCompatibility"
+  ],
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "family": { "type": "string", "minLength": 1 },
+    "triggerStage": { "type": "string", "minLength": 1 },
+    "executionOrder": { "type": "integer", "minimum": 0 },
+    "mode": { "type": "string", "enum": ["blocking", "advisory"] },
+    "timeoutBudget": { "type": "string", "pattern": "^PT" },
+    "retryPolicy": { "type": "string", "minLength": 1 },
+    "failurePolicy": { "type": "string", "minLength": 1 },
+    "requiredInputs": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "expectedOutputs": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "observabilityFields": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "workflowFamilies": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "targetCompatibility": {
+      "type": "object",
+      "propertyNames": { "type": "string", "minLength": 1 },
+      "additionalProperties": {
+        "type": "string",
+        "enum": ["full", "partial", "emulated", "unsupported"]
+      }
+    },
+    "fallbackGuidance": { "type": "string", "minLength": 1 },
+    "notes": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/schemas/manifests/catalog.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/manifests/catalog.schema.json",
+  "title": "Harness Forge Catalog",
+  "type": "object",
+  "required": ["bundles", "profiles", "targets"],
+  "properties": {
+    "bundles": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "profiles": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "targets": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}