project-tiny-context-harness 0.2.66 → 0.2.67

package/assets/skills/superpowers-long-task/SKILL.md

@@ -0,0 +1,241 @@
+---
+name: superpowers-long-task
+description: Use when directly invoked for Superpowers long-running task target prompt preparation.
+---
+
+# Superpowers Long Task Skill
+
+## Package-Managed Boundary
+
+This Skill is generated by `ty-context sync` and owned by the Harness package. Do not edit the generated `superpowers-long-task` Skill directly in a consumer project.
+
+This is Tiny Context's adapter for feeding a complete acceptance packet into the external Superpowers workflow. It is not a Superpowers official schema and 不是 Superpowers 官方 schema. It only makes the target-mode prompt explicit enough that the official Superpowers skills can do their intended work without losing Tiny Context acceptance authority.
+
+## Purpose
+
+Consumes a complete acceptance packet and emits a paste-ready Superpowers target-mode prompt. The input packet normally comes from `/normal-long-task`.
+
+Use this Skill only after the implementation/source plan and full acceptance checklist already exist or are pasted in full. Do not generate, derive, rewrite, strengthen, or repair the full checklist in this Skill. If the checklist is incomplete, stop and send the user back to `/normal-long-task` or ask for the missing fields.
+
+## Direct Invocation
+
+Use this Skill through explicit invocation:
+
+```text
+/superpowers-long-task
+```
+
+Do not rely on broad automatic keyword routing. Use `/normal-long-task` first when the implementation/source plan and full acceptance checklist do not already exist.
+
+## Use Cases
+
+Use this Skill when a complete plan/checklist packet needs:
+
+- Superpowers target-mode prompt.
+- Superpowers goal-mode prompt.
+- Superpowers 目标模式文本.
+- Superpowers-compatible Codex target prompt.
+- Maximum official Superpowers workflow value from an existing acceptance checklist.
+
+Do not trigger merely because a plan mentions TDD or subagents. The user must ask for a Superpowers target/goal prompt or equivalent execution adapter.
+
+## Required Input Packet
+
+The input must fully expose these fields:
+
+- Original requirement source or original plan summary.
+- implementation/source plan path or pasted text.
+- full acceptance checklist path or pasted text.
+- local audit path, normally `tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md`.
+- relevant Context that must be read before execution.
+- required tests / core paths.
+- Evidence Layer Separation rules.
+- Invalid Evidence Rules.
+- Completion State Machine rules.
+- UI-Facing Gate rules when any AC touches UI.
+- hard blockers or an explicit no-blocker statement.
+
+If any of these are missing required fields, stop. Do not generate the Superpowers target-mode prompt. Report the missing fields and say whether they belong in the development plan, full checklist, local audit rule, blocker section or Context reference.
+
+## Source Roles
+
+- Original requirement source prevents implementation/source plan or checklist shrinkage.
+- implementation/source plan is execution direction, not proof.
+- full acceptance checklist is the highest-priority completion standard.
+- local audit records progress, evidence, blockers and invalidating evidence only; it is not proof.
+- relevant Context remains the durable repo intent and boundary source.
+- required tests / core paths bind AC gaps to executable verification.
+
+Do not let a compact target prompt override the full checklist. The compact prompt is direction, priority and recovery navigation only. The full checklist wins conflicts.
+
+## Evidence Layer Separation
+
+Keep these layers separate in the prompt when relevant:
+
+- code implemented.
+- runtime configured.
+- runtime exercised.
+- artifact generated.
+- artifact accepted by validator.
+- API/UI reflected or API/UI reflects accepted evidence.
+- browser or user path verified.
+- final gate/check command passed.
+
+An AC cannot be complete when its required layer is missing.
+
+## Invalid Evidence Rules
+
+The prompt must reject false proof:
+
+- viewmodel-only does not prove a real page.
+- unit test does not prove real API behavior or latency.
+- artifact exists does not prove artifact accepted by validator.
+- old result does not prove current state.
+- build passes does not prove product acceptance.
+- stale, partial, smoke-only, dry-run or research evidence cannot prove full completion.
+- unresolved API/UI/data/test contradictions invalidate completion claims.
+
+## Completion State Machine
+
+Every AC starts as `unknown / not_run`.
+
+Only fresh required evidence can mark an AC complete.
+
+Any fresh browser / API / runtime / data / test contradiction must downgrade the affected AC and overall status and must be recorded as invalidating evidence. Do not preserve a previous complete status after contradictory fresh evidence appears.
+
+## UI-Facing Gate
+
+For UI-facing acceptance, the executor must open the real page path and confirm the user-visible state matches the AC. component / viewmodel / mock / unit test evidence is auxiliary unless the full checklist explicitly says otherwise.
+
+## Official Superpowers Binding
+
+Bind the target prompt to the official Skill names and their documented roles:
+
+- If the implementation/source plan is not bite-sized enough, use `superpowers:writing-plans`.
+- Prefer `superpowers:subagent-driven-development` when subagents are available.
+- Use `superpowers:executing-plans` when executing a written plan without the same-session subagent workflow.
+- AC gap -> TDD: every behavior acceptance gap uses `superpowers:test-driven-development` to write a failing test, observe failure, then implement minimally.
+- Before any completion claim, use `superpowers:verification-before-completion` against the full checklist and fresh evidence.
+- review / finish cannot override the full checklist; if the checklist is unsatisfied, continue implementation or report blockers.
+
+If Superpowers is missing, install it through the current platform's official Superpowers installation path. If installation is blocked by permissions, network or platform limits, record the blocker in local audit and do not count it as complete.
+
+## Local Audit Requirements
+
+The Superpowers target prompt must require the future executor to update local audit after each round with:
+
+- overall status.
+- each AC status and current evidence.
+- command/result/time and failure reason.
+- required test command/result/failure.
+- artifact or evidence paths.
+- blockers, missing evidence and acceptance impact.
+- deferred or narrowed scope.
+- stale, partial, smoke, dry-run, research or other invalid evidence.
+
+The local audit is not Context, not proof, not a global task manager, and not a replacement for project tests, CI, review, human acceptance, Task Contract or workflow-contract `plan.md`.
+
+## Prompt Generation Rules
+
+- The prompt must visibly output `Superpowers 输入包` for Chinese prompts or `Superpowers input packet` for English prompts.
+- The prompt must visibly output `Superpowers 执行绑定` for Chinese prompts or `Superpowers execution binding` for English prompts.
+- The prompt must identify plan path, full checklist path and local audit path at the top.
+- The prompt must state that the full checklist is the complete acceptance standard and wins conflicts.
+- The prompt must preserve hard-blocker semantics: if only locally unsatisfiable hard blockers remain, pause for the user or external owner instead of marking complete.
+- The prompt must include the resource lifecycle line: `可多开agent，agent名额不够了就关掉不用的。` or `You may use multiple agents; if agent slots run low, close idle or unnecessary agents.`
+- The prompt must fit 3850 characters including line breaks.
+- Do not include explanatory preface inside the generated prompt.
+
+Recommended compact Chinese prompt shape:
+
+```text
+实施计划: tmp/ty-context/plan-acceptance/<plan-slug>.md（source/implementation plan，非验收证明）
+完整验收清单: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md（该文件是完整验收标准，验收以这个为准。完成前必须逐项检查，不满足则继续实现。）
+执行审计: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md（临时 progress state，非 Context/proof）
+可多开agent，agent名额不够了就关掉不用的。
+本摘要只负责 direction/priority/recovery navigation；允许与完整 checklist 重叠，冲突时以完整 checklist 为准。This is not a Superpowers official schema / 不是 Superpowers 官方 schema。
+Superpowers 输入包：
+- 原始需求源/原始方案摘要：防止计划/checklist 缩水
+- 实施计划：执行方向；不够 bite-sized 时用 superpowers:writing-plans
+- 完整验收清单：最高优先级完成标准；completion gate 以它为准
+- local audit：只记 progress/evidence/blocker/invalidating evidence，非 proof
+- relevant Context：执行前读取；冲突按完整 checklist 和 Context 规则处理
+- required tests / core paths：把每个 AC gap 绑定到测试、API/UI/runtime/browser 验证
+
+如果 Superpowers 未安装，先按当前平台 official Superpowers installation path 安装；若 installation is blocked by 权限/网络/平台限制，写入 audit，不得算完成。
+Superpowers 执行绑定：
+- 先读完整验收清单，验收以它为准
+- 计划不够可执行时，用 superpowers:writing-plans 转成 bite-sized implementation plan
+- 有 subagent 支持时优先用 superpowers:subagent-driven-development；否则用 superpowers:executing-plans
+- AC gap -> TDD：每个行为验收缺口先用 superpowers:test-driven-development write a failing test 并 observe failure，再写最小实现
+- 完成声明前用 superpowers:verification-before-completion 按完整 checklist 和 fresh evidence 做 gate
+- review / finish cannot override the full checklist；不满足则继续实现或报告 blocker
+- 每轮后更新 audit：AC status、证据、命令/结果/时间、required test command/result/failure、evidence path、blocker、deferred/narrowed scope、无效证据
+
+状态机：AC 初始 unknown / not_run；只有 fresh required evidence 才能 complete；任何 fresh browser / API / runtime / data / test contradiction 必须 downgrade the affected AC and overall status，并记录 invalidating evidence。
+UI-Facing Gate：UI 验收必须打开 real page path 且用户可见状态匹配；component / viewmodel / mock / unit test 只算辅助证据，除非完整 checklist 明确说明。
+禁止完成于：只改代码/计划、只跑部分测试、旧或部分证据、runtime 未配置/未演练、artifact 未被 validator accepted、API/UI 未 reflected、强卡点未解除、API/UI/data/test 矛盾。
+```
+
+Recommended compact English prompt shape:
+
+```text
+Plan: tmp/ty-context/plan-acceptance/<plan-slug>.md (implementation/source plan, not acceptance proof)
+Full checklist: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md (complete acceptance standard; judge against it; check every item before completion)
+Local audit: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md (temporary progress state, not Context or proof)
+You may use multiple agents; if agent slots run low, close idle or unnecessary agents.
+This summary is direction/priority/recovery only; overlap is allowed and the full checklist wins conflicts. This is not a Superpowers official schema / 不是 Superpowers 官方 schema.
+Superpowers input packet:
+- Source/original requirement: prevents plan/checklist shrinkage.
+- Plan: execution direction; if not bite-sized, use superpowers:writing-plans.
+- Full checklist: acceptance authority and completion gate.
+- Local audit: progress/evidence/blockers/invalidating evidence only; not proof.
+- Relevant Context: read before execution; resolve conflicts through checklist + Context.
+- Required tests/core paths: map AC gaps to test/API/UI/runtime/browser evidence.
+
+If Superpowers is missing, install it through the current platform's official Superpowers installation path; if installation is blocked by permissions/network/platform, record in audit and do not count as complete.
+Superpowers execution binding:
+- Read the full checklist first; acceptance is judged against it.
+- Use superpowers:writing-plans if the plan is not executable enough.
+- Prefer superpowers:subagent-driven-development with subagents; otherwise use superpowers:executing-plans.
+- AC gap -> TDD: every behavior acceptance gap first uses superpowers:test-driven-development to write a failing test, observe failure, then implement minimally.
+- Before any completion claim, use superpowers:verification-before-completion against fresh evidence.
+- review / finish cannot override the full checklist; if unsatisfied, continue or report blockers.
+- After each round update audit: AC status, evidence, command/result/time, required test command/result/failure, evidence paths, blockers, deferred/narrowed scope, invalid evidence.
+
+State machine: ACs start unknown / not_run; only fresh required evidence can mark complete; any fresh browser / API / runtime / data / test contradiction downgrades the affected AC and overall status and is invalidating evidence.
+UI-Facing Gate: open the real page path and confirm visible state; component / viewmodel / mock / unit test evidence is auxiliary unless checklist says otherwise.
+Never complete on: code-only, plan-only, partial tests, stale/partial evidence, unconfigured/unexercised runtime, artifact not accepted by validator, API/UI not reflected, hard blockers, or API/UI/data/test contradictions.
+```
+
+Before final response, check the prompt length. If it exceeds 3850 characters, tighten wording while preserving paths, input roles, official Superpowers skill names, state machine, UI gate, blockers and invalid evidence.
+
+## Final Response Requirements
+
+When successful, return:
+
+- The implementation/source plan path.
+- The full checklist path.
+- The local audit path.
+- Whether required input was complete.
+- The paste-ready Superpowers target-mode prompt in a code block.
+
+When blocked, return:
+
+- Missing required fields.
+- Which source should provide each missing field.
+- A clear statement that no Superpowers target-mode prompt was generated.
+
+Do not claim any AC has passed unless the user explicitly asked for current completion audit and current evidence was inspected.
+
+## Forbidden Behaviors
+
+Do not generate, derive, rewrite, strengthen, or repair the full checklist.
+
+Do not execute the generated prompt.
+
+Do not mark any goal complete.
+
+Do not hide missing source files, ambiguous scope, weak evidence or blockers.
+
+Do not include business-domain logic, concrete provider names, API names, UI names, artifact schemas or one-off project details in this package-managed Skill.

package/dist/commands/export-context-args.js

@@ -82,7 +82,7 @@ export function helpText() {
   export-context --code [--output tmp/ty-context/context-exports/<name>.md] [--check]
   export-context --all [--check]
   export-context --code-index [--profile <id>] [--include-code <path-or-glob>] [--check]
-  export-context --source-pack [--profile <id>] [--bundle-strategy auto|area|topdir|config] [--max-pack-files 5] [--max-bundle-characters <n>] [--redaction-strict] [--prune <count>] [--check]
+  export-context --source-pack [--profile <id>] [--bundle-strategy auto|area|topdir|config] [--max-pack-files 5] [--max-bundle-characters <n>] [--redaction-strict] [--check]
   export-context --code-bundles [--profile <id>] [--include-code <path-or-glob>] [--max-pack-files 5] [--check]
   export-context --task-context <name> [--profile <id>] [--include-context <path-or-glob>] [--include-code <path-or-glob>] [--max-pack-files 5] [--redaction-strict] [--check]
 
@@ -90,7 +90,7 @@ Creates temporary Markdown artifacts for copying or external-tool ingestion.
 --full exports the project Context summary as a full-project-context artifact.
 --code exports one current implementation snapshot as a code-level-implementation artifact.
 --all exports both default artifacts in one command.
-Source Pack modes write timestamped directories plus latest/ under tmp/ty-context/context-exports/**.
+Source Pack modes write only tmp/ty-context/context-exports/latest/ and remove old timestamped rounds.
 --source-pack and --task-context are bounded to at most 5 files; --max-pack-files cannot exceed 5.
 Profiles are export selectors read from <harnessRoot>/config.yaml; verification entries are listed, not executed.
 Secret redaction is always enabled; --redaction-strict fails if redaction was required.

package/dist/lib/source-pack-export.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { artifactReport, buildManifest, pruneTimestampedExports, readPackageVersion, timestampForFile, writeArtifactSet } from "./source-pack-manifest.js";
+import { artifactReport, buildManifest, pruneTimestampedExports, readPackageVersion, writeArtifactSet } from "./source-pack-manifest.js";
 import { mergePatterns, parseContextAreas, readSourcePackProfile, validatePatternList } from "./source-pack-config.js";
 import { collectCodeRecords, collectContextArtifacts, countRedactionWarnings, repoRelative } from "./source-pack-records.js";
 import { renderBundleArtifact, renderCodeIndexArtifact, renderFullProjectContextArtifact, renderTaskContextArtifact } from "./source-pack-render.js";
@@ -10,8 +10,7 @@ export async function runSourcePackExport(projectRoot, options) {
     const maxPackFiles = options.maxPackFiles ?? DEFAULT_MAX_PACK_FILES;
     validateMaxPackFiles(options.mode, maxPackFiles);
     const now = options.now ?? new Date();
-    const timestamp = timestampForFile(now);
-    const timestampDir = path.join(projectRoot, ...DEFAULT_EXPORT_DIR.split("/"), timestamp);
+    const outputDir = path.join(projectRoot, ...DEFAULT_EXPORT_DIR.split("/"), "latest");
     const generatedAt = now.toISOString();
     const warnings = [];
     const areas = await parseContextAreas(projectRoot);
@@ -30,7 +29,7 @@ export async function runSourcePackExport(projectRoot, options) {
     const taskName = options.taskName ?? "";
     const command = options.command ?? commandFor(options);
     const toolVersion = await readPackageVersion();
-    const recommendedUploadSets = uploadSets(options.mode, timestamp, taskName);
+    const recommendedUploadSets = uploadSets(options.mode, taskName);
     const artifacts = [];
     if (options.mode === "code-index" || options.mode === "source-pack" || options.mode === "code-bundles" || options.mode === "task-context") {
         assignBundles(records, maxBundleCharacters, bundleStrategy);
@@ -47,13 +46,13 @@ export async function runSourcePackExport(projectRoot, options) {
     }
     const omitted = omittedSummary(records);
     const nonManifestArtifacts = artifacts.slice();
-    const manifestPath = `${DEFAULT_EXPORT_DIR}/${timestamp}/source-pack-manifest.json`;
+    const manifestPath = `${DEFAULT_EXPORT_DIR}/latest/source-pack-manifest.json`;
     const manifest = await buildManifest({
         projectRoot,
         generatedAt,
         command,
         maxPackFiles,
-        artifacts: nonManifestArtifacts.map((artifact) => ({ ...artifact, relativePath: `${DEFAULT_EXPORT_DIR}/${timestamp}/${artifact.name}` })),
+        artifacts: nonManifestArtifacts.map((artifact) => ({ ...artifact, relativePath: `${DEFAULT_EXPORT_DIR}/latest/${artifact.name}` })),
         warnings,
         omitted,
         recommendedUploadSets
@@ -69,7 +68,7 @@ export async function runSourcePackExport(projectRoot, options) {
     });
     for (const artifact of artifacts) {
         if (!artifact.relativePath) {
-            artifact.relativePath = `${DEFAULT_EXPORT_DIR}/${timestamp}/${artifact.name}`;
+            artifact.relativePath = `${DEFAULT_EXPORT_DIR}/latest/${artifact.name}`;
         }
     }
     if (artifacts.length > maxPackFiles) {
@@ -80,15 +79,13 @@ export async function runSourcePackExport(projectRoot, options) {
         throw new Error(`export-context --redaction-strict found ${redactionCount} redaction warning(s)`);
     }
     if (!options.check) {
-        await writeArtifactSet(projectRoot, timestampDir, artifacts);
-        if (options.prune !== undefined) {
-            await pruneTimestampedExports(projectRoot, options.prune);
-        }
+        await writeArtifactSet(projectRoot, outputDir, artifacts);
+        await pruneTimestampedExports(projectRoot, 0);
     }
     return {
         mode: options.mode,
-        outputDirectory: timestampDir,
-        outputRelativePath: repoRelative(projectRoot, timestampDir),
+        outputDirectory: outputDir,
+        outputRelativePath: repoRelative(projectRoot, outputDir),
         artifacts: artifacts.map(artifactReport),
         sourceFiles: records.map((record) => record.relative),
         sourceCodeCount: records.length,
@@ -184,8 +181,8 @@ function markdownArtifact(kind, name, content, sourceCount, sourceLineCount, war
 function meta(generatedAt, artifactName, command, toolVersion) {
     return { generatedAt, outputPath: `tmp/ty-context/context-exports/latest/${artifactName}`, command, toolVersion };
 }
-function uploadSets(mode, timestamp, taskName) {
-    const base = `${DEFAULT_EXPORT_DIR}/${timestamp}`;
+function uploadSets(mode, taskName) {
+    const base = `${DEFAULT_EXPORT_DIR}/latest`;
     const sets = {
         daily_planning: [`${base}/full-project-context.md`, `${base}/code-index.md`],
         cross_module_review: [`${base}/full-project-context.md`, `${base}/code-index.md`, `${base}/code-bundle-core.md`, `${base}/code-bundle-extended.md`],

package/dist/lib/source-pack-manifest.d.ts

@@ -19,7 +19,7 @@ export declare function buildManifest(params: {
     recommendedUploadSets: Record<string, string[]>;
 }): Promise<string>;
 export declare function artifactReport(artifact: PendingArtifact): SourcePackArtifactReport;
-export declare function writeArtifactSet(projectRoot: string, timestampDir: string, artifacts: PendingArtifact[]): Promise<void>;
+export declare function writeArtifactSet(projectRoot: string, outputDir: string, artifacts: PendingArtifact[]): Promise<void>;
 export declare function pruneTimestampedExports(projectRoot: string, keepCount: number): Promise<void>;
 export declare function timestampForFile(now: Date): string;
 export declare function readPackageVersion(): Promise<string>;

package/dist/lib/source-pack-manifest.js

@@ -35,11 +35,13 @@ export function artifactReport(artifact) {
         warning_count: artifact.warningCount
     };
 }
-export async function writeArtifactSet(projectRoot, timestampDir, artifacts) {
-    const latestDir = path.join(projectRoot, "tmp", "ty-context", "context-exports", "latest");
-    await writeArtifacts(projectRoot, timestampDir, artifacts);
-    await fs.rm(latestDir, { recursive: true, force: true });
-    await writeArtifacts(projectRoot, latestDir, artifacts);
+export async function writeArtifactSet(projectRoot, outputDir, artifacts) {
+    const outputRelative = repoRelative(projectRoot, outputDir);
+    if (!outputRelative.startsWith("tmp/ty-context/context-exports/")) {
+        throw new Error("Source Pack output directory must stay under tmp/ty-context/context-exports/**");
+    }
+    await fs.rm(outputDir, { recursive: true, force: true });
+    await writeArtifacts(projectRoot, outputDir, artifacts);
 }
 export async function pruneTimestampedExports(projectRoot, keepCount) {
     if (!Number.isInteger(keepCount) || keepCount < 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-tiny-context-harness",
-  "version": "0.2.66",
+  "version": "0.2.67",
   "description": "Minimal project memory and validation harness for AI coding agents.",
   "license": "MIT",
   "author": "Seven128",