@pzy560117/codex-harness 0.1.4 → 0.1.6

package/package-source/install-manifest.json

@@ -0,0 +1,523 @@
+{
+  "schemaVersion": "0.1",
+  "status": "draft",
+  "package": "codex-harness",
+  "version": "0.1.5",
+  "installModes": [
+    {
+      "name": "user",
+      "description": "Install shared package assets outside project repositories."
+    },
+    {
+      "name": "full",
+      "description": "Install project runtime and vendor package assets into one project."
+    },
+    {
+      "name": "project",
+      "description": "Initialize only project runtime state and project truth sources."
+    },
+    {
+      "name": "vendor",
+      "description": "Copy full package assets into a project for offline or isolated use."
+    }
+  ],
+  "entries": [
+    {
+      "source": "templates/runtime/AGENTS.md",
+      "destination": "AGENTS.md",
+      "scope": "project",
+      "kind": "runtime-rule",
+      "mutable": true
+    },
+    {
+      "source": "templates/bootstrap-codex-harness.ps1",
+      "destination": "tools/install/bootstrap-codex-harness.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/codex-loop.ps1",
+      "destination": "tools/harness/codex-loop.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/doctor.ps1",
+      "destination": "tools/harness/doctor.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/verify.ps1",
+      "destination": "tools/harness/verify.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/config/env-check.ps1",
+      "destination": "tools/install/env-check.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/task.json",
+      "destination": "task.json",
+      "scope": "project",
+      "kind": "task-state",
+      "mutable": true
+    },
+    {
+      "source": "templates/runtime/progress.txt",
+      "destination": "progress.txt",
+      "scope": "project",
+      "kind": "task-state",
+      "mutable": true
+    },
+    {
+      "source": "templates/runtime/smoke-task.json",
+      "destination": "tools/harness/templates/smoke-task.json",
+      "scope": "project",
+      "kind": "task-template",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/project-task-template.json",
+      "destination": "tools/harness/templates/project-task-template.json",
+      "scope": "project",
+      "kind": "task-template",
+      "mutable": false
+    },
+    {
+      "source": "templates/trace/trace.schema.json",
+      "destination": "docs/harness/trace.schema.json",
+      "scope": "project",
+      "kind": "trace-schema",
+      "mutable": false
+    },
+    {
+      "source": "install-manifest.json",
+      "destination": ".codex-harness/locks/package.lock.json",
+      "scope": "project",
+      "kind": "generated-lock",
+      "mutable": false
+    },
+    {
+      "source": "install-manifest.json",
+      "destination": ".codex-harness/manifests/install-manifest.json",
+      "scope": "project",
+      "kind": "install-manifest-snapshot",
+      "mutable": false
+    },
+    {
+      "source": "templates/config/codex-config.toml",
+      "destination": ".codex/config.toml",
+      "scope": "project",
+      "kind": "codex-config",
+      "mutable": true
+    },
+    {
+      "source": "templates/config/codex-readme.md",
+      "destination": ".codex/README.md",
+      "scope": "project",
+      "kind": "codex-config",
+      "mutable": true
+    },
+    {
+      "source": "templates/hooks/hooks.json",
+      "destination": ".codex/hooks.json",
+      "scope": "project",
+      "kind": "codex-hook",
+      "mutable": true
+    },
+    {
+      "source": "templates/hooks/hook-stop-verify.ps1",
+      "destination": "tools/harness/hook-stop-verify.ps1",
+      "scope": "project",
+      "kind": "codex-hook",
+      "mutable": false
+    },
+    {
+      "source": "templates/scripts/harness/harness-governance-check.ps1",
+      "destination": "scripts/harness/harness-governance-check.ps1",
+      "scope": "project",
+      "kind": "runtime-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/scripts/ai-workflow/check-ai-sync-drift.ps1",
+      "destination": "tools/install/ai-workflow/check-ai-sync-drift.ps1",
+      "scope": "project",
+      "kind": "sync-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/task-run-profile.json",
+      "destination": ".codex/task-run-profile.json",
+      "scope": "project",
+      "kind": "codex-config",
+      "mutable": true
+    },
+    {
+      "source": "templates/config/agents/",
+      "destination": ".codex/agents/",
+      "scope": "project",
+      "kind": "codex-agent",
+      "mutable": true
+    },
+    {
+      "source": "templates/package-assets/rules/",
+      "destination": ".codex/rules/",
+      "scope": "project",
+      "kind": "codex-rule",
+      "mutable": true
+    },
+    {
+      "source": "templates/prompts/",
+      "destination": ".codex/prompts/",
+      "scope": "project",
+      "kind": "codex-prompt",
+      "mutable": true
+    },
+    {
+      "source": "templates/package-assets/skills/",
+      "destination": ".agents/skills/",
+      "scope": "project",
+      "kind": "skill",
+      "mutable": true
+    },
+    {
+      "source": "templates/package-assets/workflows/",
+      "destination": ".agents/workflows/",
+      "scope": "project",
+      "kind": "workflow",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/repo-map.md",
+      "destination": "docs/ai/repo-map.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/architecture-brief.md",
+      "destination": "docs/ai/architecture-brief.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/CURRENT_TASK.md",
+      "destination": "docs/ai/CURRENT_TASK.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/PROJECT_CONTEXT.md",
+      "destination": "docs/ai/PROJECT_CONTEXT.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/DECISIONS.md",
+      "destination": "docs/ai/DECISIONS.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/API_MAP.md",
+      "destination": "docs/ai/API_MAP.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/DB_SCHEMA.md",
+      "destination": "docs/ai/DB_SCHEMA.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/KNOWN_ISSUES.md",
+      "destination": "docs/ai/KNOWN_ISSUES.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/CHANGELOG_AI.md",
+      "destination": "docs/ai/CHANGELOG_AI.md",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/context/service-dependency-matrix.yaml",
+      "destination": ".service-matrix/dependencies.yaml",
+      "scope": "project",
+      "kind": "project-context",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/architecture-constraints.md",
+      "destination": "docs/architecture/constraints.md",
+      "scope": "project",
+      "kind": "architecture-constraints",
+      "mutable": true
+    },
+    {
+      "source": "templates/spec/",
+      "destination": "docs/spec/",
+      "scope": "project",
+      "kind": "spec",
+      "mutable": true
+    },
+    {
+      "source": "templates/testing/",
+      "destination": "docs/testing/",
+      "scope": "project",
+      "kind": "testing",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/harness-architecture.md",
+      "destination": "docs/harness/architecture.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/knowledge-architecture.md",
+      "destination": "docs/harness/knowledge-architecture.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/knowledge-import.md",
+      "destination": "docs/harness/knowledge-import.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/knowledge-lint.md",
+      "destination": "docs/harness/knowledge-lint.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/prompt-knowledge-integration.md",
+      "destination": "docs/harness/prompt-knowledge-integration.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/mcp-knowledge-governance.md",
+      "destination": "docs/harness/mcp-knowledge-governance.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/code-semantics-and-navigation.md",
+      "destination": "docs/harness/code-semantics-and-navigation.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/rule-governance.md",
+      "destination": "docs/harness/rule-governance.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/governance-auto-repair.md",
+      "destination": "docs/harness/governance-auto-repair.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/regression-rules.md",
+      "destination": "docs/harness/regression-rules.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/service-dependency-matrix.md",
+      "destination": "docs/harness/service-dependency-matrix.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/team-knowledge-sync.md",
+      "destination": "docs/harness/team-knowledge-sync.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/trace-format.md",
+      "destination": "docs/harness/trace-format.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/task-session-strategy.md",
+      "destination": "docs/harness/task-session-strategy.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/spec-to-ui-to-code-workflow.md",
+      "destination": "docs/harness/spec-to-ui-to-code-workflow.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/frontend-quality-rules.md",
+      "destination": "docs/harness/frontend-quality-rules.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/install-manifest-governance.md",
+      "destination": "docs/harness/install-manifest-governance.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/governance/sandbox-policy.md",
+      "destination": "docs/harness/sandbox-policy.md",
+      "scope": "project",
+      "kind": "harness-doc",
+      "mutable": true
+    },
+    {
+      "source": "templates/docs/requirement-prep-kit/",
+      "destination": "docs/requirement-prep-kit/",
+      "scope": "project",
+      "kind": "requirement-template",
+      "mutable": true
+    },
+    {
+      "source": "templates/knowledge/",
+      "destination": "docs/knowledge/",
+      "scope": "project",
+      "kind": "knowledge",
+      "mutable": true
+    },
+    {
+      "source": "templates/package-assets/root/install-agent.ps1",
+      "destination": ".agents/install-agent.ps1",
+      "scope": "vendor",
+      "kind": "installer",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/root/install-agent-here.ps1",
+      "destination": ".agents/install-agent-here.ps1",
+      "scope": "vendor",
+      "kind": "installer",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/root/install-user.ps1",
+      "destination": ".agents/install-user.ps1",
+      "scope": "vendor",
+      "kind": "installer",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/root/init-project.ps1",
+      "destination": ".agents/init-project.ps1",
+      "scope": "vendor",
+      "kind": "installer",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/root/README.md",
+      "destination": ".agents/README.md",
+      "scope": "vendor",
+      "kind": "package-doc",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/root/PACKAGE.md",
+      "destination": ".agents/PACKAGE.md",
+      "scope": "vendor",
+      "kind": "package-doc",
+      "mutable": false
+    },
+    {
+      "source": "install-manifest.json",
+      "destination": ".agents/install-manifest.json",
+      "scope": "vendor",
+      "kind": "install-manifest",
+      "mutable": false
+    },
+    {
+      "source": "install-manifest.schema.json",
+      "destination": ".agents/install-manifest.schema.json",
+      "scope": "vendor",
+      "kind": "install-manifest-schema",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/workflows/",
+      "destination": ".agents/workflows/",
+      "scope": "vendor",
+      "kind": "workflow",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/scripts/",
+      "destination": ".agents/scripts/",
+      "scope": "vendor",
+      "kind": "support-script",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/.specify/",
+      "destination": ".agents/.specify/",
+      "scope": "vendor",
+      "kind": "speckit-template",
+      "mutable": false
+    },
+    {
+      "source": "templates/package-assets/skills/",
+      "destination": ".agents/skills/",
+      "scope": "vendor",
+      "kind": "skill",
+      "mutable": false
+    },
+    {
+      "source": "templates/",
+      "destination": ".agents/docs/codex-harness-engineering/templates/",
+      "scope": "vendor",
+      "kind": "template",
+      "mutable": false
+    }
+  ]
+}

package/package-source/install-manifest.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-harness.local/schemas/install-manifest.schema.json",
+  "title": "Codex Harness Install Manifest",
+  "type": "object",
+  "required": ["schemaVersion", "status", "package", "version", "installModes", "entries"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+$" },
+    "status": { "type": "string", "enum": ["draft", "stable", "deprecated"] },
+    "package": { "type": "string", "const": "codex-harness" },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "installModes": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 4,
+      "allOf": [
+        { "contains": { "type": "object", "properties": { "name": { "const": "full" } }, "required": ["name"] } },
+        { "contains": { "type": "object", "properties": { "name": { "const": "user" } }, "required": ["name"] } },
+        { "contains": { "type": "object", "properties": { "name": { "const": "project" } }, "required": ["name"] } },
+        { "contains": { "type": "object", "properties": { "name": { "const": "vendor" } }, "required": ["name"] } }
+      ],
+      "items": {
+        "type": "object",
+        "required": ["name", "description"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string", "enum": ["full", "user", "project", "vendor"] },
+          "description": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "entries": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["source", "destination", "scope", "kind", "mutable"],
+        "additionalProperties": false,
+        "allOf": [
+          {
+            "if": { "properties": { "scope": { "const": "user" } }, "required": ["scope"] },
+            "then": {
+              "properties": {
+                "destination": { "$ref": "#/$defs/userDestinationPath" }
+              }
+            }
+          },
+          {
+            "if": { "properties": { "scope": { "enum": ["project", "vendor"] } }, "required": ["scope"] },
+            "then": {
+              "properties": {
+                "destination": { "$ref": "#/$defs/managedRelativePath" }
+              }
+            }
+          }
+        ],
+        "properties": {
+          "source": { "$ref": "#/$defs/managedRelativePath" },
+          "destination": { "type": "string", "minLength": 1 },
+          "scope": { "type": "string", "enum": ["project", "user", "vendor"] },
+          "kind": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "mutable": { "type": "boolean" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "managedRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![A-Za-z]:)(?!/)(?!.*\\\\)(?!.*(^|/)\\.\\.(/|$)).+$"
+    },
+    "userDestinationPath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^%USERPROFILE%/(?!.*\\\\)(?!.*(^|/)\\.\\.(/|$)).+$"
+    }
+  }
+}